Group

A set of User records.

Groups are sets of users. They can contain individual users, other groups, the users in a particular role or territory, or the users in a particular role or territory plus all the users below that role or territory in the hierarchy.

create(), delete(), describeSObjects(), getDeleted(), getUpdated(), query(), search(), retrieve(), update(), upsert()

  • Authenticated internal and external users can access this object.
  • Type: picklist
  • Properties: Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update
  • Description: This record’s default division. Only applicable if divisions are enabled.
  • Type: textarea
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 62.0
  • Description: The description of the group.

  • Type: string

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 24.0

  • Description:

    The name of the object in the API. This name can contain only underscores and alphanumeric characters, and must be unique in your org. It must begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores. In managed packages, this field prevents naming conflicts on package installations. With this field, a developer can change the object’s name in a managed package and the changes are reflected in a subscriber’s organization. This name is unique by group type and corresponds to Group Name in the user interface.

    Only your Salesforce org’s internal users can access this field.

    When creating large sets of data, always specify a unique DeveloperName for each record. If no DeveloperName is specified, performance may slow while Salesforce generates one for each record.

  • Type: boolean

  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update

  • Introduced: API version 18.0

  • Description:

    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 is only available for groups of type Regular and Queue. This field corresponds to the Grant Access Using Hierarchies checkbox on the detail pages of public groups and queues.

    For groups of type Regular, this field available in API version 18.0 and later and has a default value of true.

    For groups of type Queue, this field is available in API version 67.0 and later. The default value of this field for queues depends on the value of the org-level setting “Grant access using hierarchies by default in new queues.”

  • Default value: false

  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Introduced: API version 8.0
  • Description: Indicates whether the email is sent (true) or not sent (false) to the group members. The email is sent to queue members as well.
  • Default value: false
  • Type: email
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Email address for a group of type Case. Applies only for a case queue.
  • Type: string
  • Properties: Create, Filter, Group, idLookup, Sort, Update
  • Description: Required. Name of the group. Corresponds to Label on the user interface.
  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 32.0
  • Description: The ID of the queue routing configuration associated with the queue.
  • Relationship name: QueueRoutingConfig
  • Relationship type: relationship
  • Refers to: QueueRoutingConfig

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Description:

    Represents the ID of the associated groups. For groups of type “Role,” the ID of the associated UserRole. The RelatedId field is polymorphic.

    This is a polymorphic relationship field.

  • Relationship name: Related

  • Relationship type: polymorphic

  • Refers to: ARAccountTypeJunc, Portal, SharingSet, Territory, Territory2, User, UserRole

  • Type: picklist
  • Properties: Create, Filter, Group, Restricted picklist, Sort
  • Description: Required. Type of the group. One of the following values: Only Personal, Regular, and Queue can be used when creating a group. The other values are reserved.
  • Possible values:
    • AllCustomerPortal — AllCustomerPortal — Public group that includes all Customer Portal or Customer Community Plus users. This type is only available when a Customer Portal or a Customer Site is enabled for your org.
    • ChannelProgramGroup — ChannelProgramGroup — Public group for partners in a channel program.
    • CollaborationGroup — CollaborationGroup — Chatter group.
    • DataAnalytics — DataAnalytics — Public group for Tableau Next and Data 360 users.
    • Manager — Manager — Public group that includes a user’s direct and indirect managers. This group is read-only.
    • ManagerAndSubordinatesInternal — ManagerAndSubordinatesInternal — Public group that includes a user and the user’s direct and indirect reports. This group is read-only.
    • Organization — Organization — Public group that includes all the User records in the organization. This group is read-only.
    • Participant — Participant — Compliant Data Sharing group that includes internal users who have the Use Compliant Data Sharing permission. A group can contain other participant groups only, or a group can contain both internal users with the Use Compliant Data Sharing permission and other participant groups. This value is only available when Compliant Data Sharing is enabled for your org.
    • PRMOrganization — PRMOrganization — Public group that includes all the partners in an organization that has the partner site or portal feature enabled.
    • Queue — Queue — Public group that includes all the User records that are members of a queue.
    • Regular — Regular — Standard public group. When you create() a group, its type must be Regular or DataAnalytics, unless a partner site or portal is enabled for the organization, in which case the type can be Regular, DataAnalytics, or PRMOrganization.
    • Role — Role — Public group that includes all the User records in a particular UserRole.
    • RoleAndSubordinates — RoleAndSubordinates — Public group that includes all the User records in a particular UserRole and all the User records in any subordinate UserRole. Only available when digital experiences is enabled for your org and Experience Cloud site users are created with external account roles other than a shared person account role.
    • RoleAndSubordinatesInternal — RoleAndSubordinatesInternal — Public group that includes all the User records in an internal UserRole, excluding customer and partner roles, and all the User records in any subordinate internal UserRole.
    • SharingRecordCollGroup — SharingRecordCollGroup — Public group that has access to a SharingRecordCollection.
    • Territory — Territory — Public group that includes all the User records in an organization that has the territory feature enabled.
    • TerritoryAndSubordinates — TerritoryAndSubordinates — Public group that includes all the User records in a particular UserRole and all the User records in any subordinateUserRole in an organization that has the territory feature enabled.

Unlike users, this object can be deleted.

Only public groups are accessible via the API. Personal groups are not available.

In API version 34.0 and later, you can query a group using Related.Name to retrieve the group’s name. Related.Name is supported for public groups, user roles, territories, manager groups, and user names.

In API version 13.0 and later, if you delete a public group, it is deleted even if it has been used in sharing, consistent with the behavior for UserRole. In versions before 13.0, such sharing prevents the record from being deleted.