---
schema_version: "1"
id: 16dfc01306f7a6894cee7c3ae9875eea0f8891a88004bb2f95a4026265c16655
title: DelegateGroup
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_delegategroup.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_delegategroup.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 1c6887d0ed09bcb3beb22fe967ea3bedd650198e47b8eb0268f8d9081cc8ed4a
description: Represents a group of users who have the same administrative privileges. These groups are different from public groups used for sharing.
---
# DelegateGroup

Represents a group of users who have the same administrative privileges. These groups are different from public groups used for sharing.

This type extends 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.") metadata type and inherits its fullName field.

## File Suffix and Directory Location

DelegateGroup components have the suffix .delegateGroup and are stored in the delegateGroups folder. The file prefix must match the developer name of the delegate group. For example, a delegate group with a developer name of MyDelegateGroup would have a file name of MyDelegateGroup.delegateGroup.

## Version

DelegateGroup components are available in API version 36.0 and later.

## Special Access Rules

Only users with the “View Setup and Configuration” permission can be delegated administrators. As of Spring ’20 and later, only users with “View Setup” or “Configuration” permission can access this object.

## Fields

| Field Name | Field Type | Description |
| --- | --- | --- |
| customObjects | string\[\] | The custom objects associated with the group. Delegated administrators can customize nearly every aspect of each of those custom objects, including creating a custom tab. However, they can’t create or modify relationships on the objects or set organization-wide sharing defaults. Delegated administrators must have access to custom objects to access the merge fields on those objects from formulas. |
| groups | string\[\] | The groups with users assigned by delegated administrators. |
| label | string | Required. The delegated group’s non-API name. |
| loginAccess | boolean | Required. Allows users in this group to log in as users in the role hierarchy that they administer (true) or not (false). Depending on your organization settings, individual users must grant login access to allow their administrators to log in as them. |
| permissionSetGroups | string\[\] | The permission set groups that can be assigned to users in specified roles and all subordinate roles by delegated administrators. |
| permissionSets | string\[\] | The permission sets that can be assigned to users in specified roles and all subordinate roles by delegated administrators. |
| profiles | string\[\] | The profiles that can be assigned to users by delegated administrators. |
| roles | string\[\] | The roles and subordinates for which delegated administrators of the group can create and edit users. |

## Declarative Metadata Sample Definition

The following is an example of a DelegateGroup component.

<?xml version="1.0" encoding="UTF-8"?>
<DelegateGroup xmlns="http://soap.sforce.com/2006/04/metadata">
    <label\>MyDelegateGroup</label\>
    <loginAccess\>true</loginAccess\>
    <name\>MyDelegateGroup</name\>
    <profiles\>Chatter Free User</profiles\>
    <profiles\>Chatter Moderator User</profiles\>
    <profiles\>Marketing User</profiles\>
    <permissionSetGroups\>My Permission Set Group</permissionSetGroups\>
    <permissionSets\>My Permset</permissionSets\>
    <roles\>LesserBossMan</roles\>
</DelegateGroup\>

The following is an example package.xml that references the previous definition.

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types\>
        <members\>\*</members\>
        <name\>DelegateGroup</name\>
    </types\>
    <version\>68.0</version\>
</Package\>

## 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).