UserManagementSettings

Represents a selection of user management options that appear on the User Management Settings Setup page.

In the package manifest, all organization settings metadata types are accessed using the Settings name. See Settings for details.

Parent Type 

This type extends Metadata and inherits its fields.

File Suffix and Directory Location 

UserMangementSettings are stored in the UserManagement.settings directory. The .settings files are different from other named components because there’s only one settings file for each settings component.

Version 

Manage org-wide settings for certain options. User Management Settings are available in API version 46.0 and later.

Fields 

enableCanAnswerContainUsername 

  • Type: boolean
  • Required: No

enableConcealPersonalInfo 

  • Type: boolean

  • Required: No

  • Description: Indicates if personal information fields in user records are hidden from external users (true) or not (false). When this field is set to true, 10 personal information fields are hidden. The default value is false. This field is unavailable for orgs created in Winter ’22 or later.

    Salesforce recommends that you use the enableEnhancedConcealPersonalInfo field instead of enableConcealPersonalInfo. Before you set the enableEnhancedConcealPersonalInfo field to true, make sure that enableConcealPersonalInfo is set to false.

enableContactlessExternalIdentityUsers 

  • Type: boolean

  • Required: No

  • Introduced: API version 47.0

  • Description: If true and your org has the External Identity license, you can create contactless users. Having users without contact information reduces the overhead of managing customers. Purchase the External Identity license to access the Customer 360 Identity product.

    The default is false.

enableEnhancedConcealPersonalInfo 

  • Type: boolean
  • Required: No
  • Introduced: API version 53.0
  • Description: Indicates if personal information fields in user records are hidden from external users (true) or not (false). When this field is set to true, you can choose which fields are classified as personal information and hidden on the User Management Settings Setup page. The default value is false. Before you set the enableEnhancedConcealPersonalInfo field to true, make sure that enableConcealPersonalInfo is set to false.

enableEnhancedConcealPersonalInfoForGuest 

  • Type: boolean
  • Required: No

enableEnhancedPermsetMgmt 

  • Type: boolean
  • Required: No
  • Description: If you enable Enhanced Permission Set Component Views (true), you can work with permission sets more easily. For example, when you have large numbers of Apex class assignments for permission sets, you can enable a paginated result set, standard filtering, and sorting.

enableEnhancedProfileMgmt 

  • Type: boolean
  • Required: No
  • Description: If you enable Enhanced Profile Lists Views (true), you can quickly view, customize, and edit list data.

enableEnhcUiUserAccessPolicies 

  • Type: boolean
  • Required: No
  • Introduced: API version 60.0
  • Description: Indicates whether you create and manage user access policies through an improved user interface (true) or not (false). The default value is false. If user access policies aren’t enabled, this field has no effect. If user access policies are enabled, this field is automatically set to true, but you can change it to false.

enableNewProfileUI 

  • Type: boolean
  • Required: No
  • Description: If you enable Enhanced Profile User Interface (true), you can use the streamlined, enhanced profile user interface to browse, search, and modify settings. You can use only one user interface at a time.

enableProfileFiltering 

  • Type: boolean

  • Required: No

  • Introduced: API version 50.0

  • Description: With profile filtering enabled (true), you can restrict who sees profile names to the users who require the access for their job roles. If profile filtering is disabled (false), users can see all profiles in a Salesforce org, regardless of which permissions they have.

    Profile names are also exposed when users with permissions to perform the following tasks take these actions:

    • Create a tab or record type with a wizard step that includes the assignment of tabs and record types to profiles.
    • Configure a login flow where viewing profile lists is required to make flow associations.
    • Set up delegated admins where looking up profiles is needed to identify assignable profiles.
    • Administer an org as a delegated customer admin.
    • Administer an org as a delegated admin to view and assign profiles of the delegated group.

enableRestrictEmailDomains 

  • Type: boolean
  • Required: No
  • Introduced: API version 53.0
  • Description: Indicates whether the Email Domain Allowlist is visible (true) or hidden (false) in Setup. The default value is false.

enableScrambleUserData 

  • Type: boolean
  • Required: No
  • Introduced: API version 47.0
  • Description: If you enable Let Users Scramble Their User Data (true), users can request that Salesforce remove all their personal data. Because Salesforce can’t delete information, it scrambles their data. Scrambling a user’s data is unrecoverable. So this org-wide setting serves as an extra precaution. If a user requests it, you scramble the data programmatically with the obfuscateUser Apex method. You can use the method, for example, in a custom Apex trigger, workflow, or the Developer Console.

enableUserSelfDeactivate 

  • Type: boolean
  • Required: No
  • Description: If you enable User Self Deactivate (true), users can deactivate their Experience Cloud site or Chatter accounts.

enhancedPermSetList 

  • Type: boolean
  • Required: No
  • Introduced: API version 63.0
  • Description: Indicates whether you manage permission sets with an updated user interface on the Permissions Setup page (true) or not (false). The default value is false.

enhancedUserListView 

  • Type: boolean
  • Required: No
  • Introduced: API version 62.0
  • Description: Indicates whether you manage users with an updated user interface on the Users Setup page (true) or not (false). The default value is false.

enhancedUserRoleListView 

  • Type: boolean
  • Required: No
  • Introduced: API version 63.0
  • Description: Indicates whether you manage roles with an updated user interface on the Roles Setup page (true) or not (false). The default value is false.

groupSummaryUIEnhancement 

  • Type: boolean
  • Required: No
  • Introduced: API version 62.0
  • Description: Indicates whether you use an improved user interface to add or remove public group members through the group’s summary page true or not (false). If this field is set to true, you can still manage public group membership through the group’s detail page. The default value is true.

permsetsInFieldCreation 

  • Type: boolean
  • Required: No
  • Introduced: API version 56.0
  • Description: If true, users can assign field-level security to permission sets instead of to profiles when creating a field on an object, setting field-level security on a field, or changing a field type on a field. The default is false.

personalScopeAccessEnabled 

  • Type: boolean
  • Required: No

psaExpirationUIEnabled 

  • Type: boolean
  • Required: No
  • Introduced: API version 52.0
  • Description: Indicates if admins can use an updated user interface that includes an assignment expiration for permission sets and permission set groups (true) or not (false). The default value is false.

restrictedProfileCloning 

  • Type: boolean
  • Required: No
  • Introduced: API version 50.0
  • Description: When enabled (true), only permissions accessible to your org are enabled when you clone profiles. When disabled (false), all permissions currently enabled in the source profile are also enabled for the cloned profile, even if your org can’t currently access them.

userAccessPoliciesEnabled 

  • Type: boolean
  • Required: No
  • Introduced: API version 58.0
  • Description: Indicates if user access policies are enabled (true) or not (false). With user access policies, you can automate and migrate your users’ assignments to managed package licenses, permission sets, and other access mechanisms based on criteria that you set. The default value is false.

userFieldHistoryTracking 

  • Type: boolean
  • Required: No
  • Introduced: API version 64.0
  • Description: Indicates if user field history tracking is enabled (true) or not (false). With user field history tracking, you can keep track of changes in user fields. The default value is false.

Declarative Metadata Sample Definition 

The following is an example of a UserManagementSettings component.

1<?xml version="1.0" encoding="UTF-8"?>
2<UserManagementSettings xmlns="http://soap.sforce.com/2006/04/metadata" 
3xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
4    <enableConcealPersonalInfo>false</enableConcealPersonalInfo>
5    <enableContactlessExternalIdentityUsers>false</enableContactlessExternalIdentityUsers>
6    <enableEnhancedConcealPersonalInfo>true</enableEnhancedConcealPersonalInfo>
7    <enableEnhancedPermsetMgmt>false</enableEnhancedPermsetMgmt>
8    <enableEnhancedProfileMgmt>true</enableEnhancedProfileMgmt>
9    <enableNewProfileUI>false</enableNewProfileUI>
10    <enableProfileFiltering>false</enableProfileFiltering>
11    <enableRestrictEmailDomains>true</enableRestrictEmailDomains>
12    <enableScrambleUserData>false</enableScrambleUserData>
13    <enableUserSelfDeactivate>false</enableUserSelfDeactivate>
14    <enhancedPermSetList>true</enhancedPermSetList>
15    <enhancedUserListView>true</enhancedUserListView>
16    <enhancedUserRoleListView>true</enhancedUserRoleListView>
17    <groupSummaryUIEnhancement>true</groupSummaryUIEnhancement>
18    <restrictedProfileCloning>true</restrictedProfileCloning>
19    <userAccessPoliciesEnabled>true</userAccessPoliciesEnabled>
20</UserManagementSettings>

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

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3    <types>
4        <members>UserManagement</members>
5        <name>Settings</name>
6    </types>
7    <version>53.0</version>
8</Package>

Wildcard Support in the Manifest File 

The wildcard character * (asterisk) in the package.xml manifest file doesn’t apply to metadata types for feature settings. The wildcard applies only when retrieving all settings, not for an individual setting. For details, see Settings. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.