---
schema_version: "1"
id: 0d5becdff93c45c02918e7412153203528e8155f386f0f3f228eea4650c4bd73
title: Group
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_group.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_group.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: ced1f7609dbeb9e9304ec625727eb035f13610d470bd4f5e6a5e8928dbbb9404
description: Represents a set of public groups, which can have users, roles, and other groups.
---
# Group

Represents a set of public groups, which can have users, roles, and other groups.

## Declarative Metadata File Suffix and Directory Location

The file suffix for group components is .group and components are stored in the groups directory of the corresponding package directory.

## Version

Group components are available in API version 24.0 and later.

## Special Access Rules

As of Spring ’20 and later, only authenticated internal and external users can access this type.

## Fields

![Note](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note.png)

#### Note

Members of the public group aren’t migrated when you deploy the group type.

This metadata type represents the valid values that define a group:

| Field Name | Field Type | Description |
| --- | --- | --- |
| description | string | The description for the group. Available in API version 62.0 and later. |
| doesIncludeBosses | boolean | Required. Indicates whether records shared with users in this group are also shared with users higher in the role hierarchy (true) or not (false). This field corresponds to the Grant Access Using Hierarchies checkbox on the group’s detail page. Available in API version 18.0 and later. |
| fullName | string | The unique identifier for API access. The fullName can contain only underscores and alphanumeric characters. It must be unique, begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores. This field is inherited from the [Metadata](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/metadata.htm "The base class for all metadata types. You can’t edit this object. A component is an instance of a metadata type.") component. Corresponds to **Group Name** in the user interface. |
| name | string | Required. The name of the group. Corresponds to **Label** in the user interface. |

## Declarative Metadata Sample Definition

The following is the definition of a group.

<?xml version="1.0" encoding="UTF-8"?>
<Group xmlns="http://soap.sforce.com/2006/04/metadata">
    <doesIncludeBosses\>true</doesIncludeBosses\>
    <fullName\>admin</fullName\>
    <name\>test</name\>
</Group\>

## Wildcard Support in the Manifest File

This metadata type supports the wildcard character \* (asterisk) in the package.xml manifest file. For information about using the manifest file, see [Deploying and Retrieving Metadata with the Zip File](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/file_based_zip_file.htm).