EntitlementSettings

Represents an organization’s entitlement settings.

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 

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

Version 

Introduced in API version 27.0.

Fields 

assetLookupLimitedToActiveEntitlementsOnAccount 

  • Type: boolean
  • Required: No
  • Description: Indicates whether entitlements-related lookup filters on cases return only the assets related to the active entitlements on the case’s account (true) or not (false).

assetLookupLimitedToActiveEntitlementsOnContact 

  • Type: boolean
  • Required: No
  • Description: Indicates whether entitlements-related lookup filters on cases return only the assets related to the active entitlements on the case’s contact (true) or not (false).

assetLookupLimitedToSameAccount 

  • Type: boolean
  • Required: No
  • Description: Indicates whether entitlements-related lookup filters on cases return only the assets related to the case’s account (true) or not (false).

assetLookupLimitedToSameContact 

  • Type: boolean
  • Required: No
  • Description: Indicates whether entitlements-related lookup filters on cases return only the assets related to the case’s contact (true) or not (false).

enableAgenticMilestones 

  • Type: boolean
  • Required: No

enableEntitlements 

  • Type: boolean
  • Required: Yes
  • Description: Indicates whether entitlements are enabled (true) or not (false).

enableEntitlementVersioning 

  • Type: boolean
  • Required: Yes
  • Introduced: API version 28.0
  • Description: Indicates whether entitlement versioning is enabled (true) or not (false).

enableMilestoneFeedItem 

  • Type: boolean
  • Required: No
  • Introduced: API version 47.0
  • Description: When set to true, indicates whether to post to the feed and the record owner’s profile page when a milestone is completed or violated. When set to false, indicates that no post occurs when a milestone is completed or violated.

enableMilestonePurgeEnabled 

  • Type: boolean
  • Required: No

enableMilestoneStoppedTime 

  • Type: boolean
  • Required: No
  • Introduced: API version 47.0
  • Description: Indicates whether to show the Stopped Time and Actual Elapsed Time fields on an entitlement milestone (true) or not (false).

enableOverdueMilestoneIgnoreBh 

  • Type: boolean
  • Required: No

enablePauseMilestone 

  • Type: boolean
  • Required: No

enableSimplifiedSLASetup 

  • Type: boolean
  • Required: No

enableTimeToNextMilestone 

  • Type: boolean
  • Required: No

entitlementLookupLimitedToActiveStatus 

  • Type: boolean
  • Required: No
  • Description: Indicates whether entitlements-related lookup filters on cases return only active entitlements (true) or not (false).

entitlementLookupLimitedToSameAccount 

  • Type: boolean
  • Required: No
  • Description: Indicates whether entitlements-related lookup filters on cases return only the entitlements related to the case’s account (true) or not (false).

entitlementLookupLimitedToSameAsset 

  • Type: boolean
  • Required: No
  • Description: Indicates whether entitlements-related lookup filters on cases return only the entitlements related to the case’s asset (true) or not (false).

entitlementLookupLimitedToSameContact 

  • Type: boolean
  • Required: No
  • Description: Indicates whether entitlements-related lookup filters on cases return only the entitlements related to the case’s contact (true) or not (false).

ignoreMilestoneBusinessHours 

  • Type: boolean
  • Required: No
  • Introduced: API version 47.0
  • Description: Indicates whether to show the time remaining on an event milestone in actual hours (true) or business hours (false).

Declarative Metadata Sample Definition 

This is a sample entitlements settings file.

1<?xml version="1.0" encoding="UTF-8"?>
2<EntitlementSettings xmlns="http://soap.sforce.com/2006/04/metadata">   
3    <assetLookupLimitedToActiveEntitlementsOnAccount>
4        false
5    </assetLookupLimitedToActiveEntitlementsOnAccount>   
6    <assetLookupLimitedToActiveEntitlementsOnContact>
7        false
8    </assetLookupLimitedToActiveEntitlementsOnContact>   
9    <assetLookupLimitedToSameAccount>
10        false
11    </assetLookupLimitedToSameAccount>   
12    <assetLookupLimitedToSameContact>
13        false
14    </assetLookupLimitedToSameContact>   
15    <enableEntitlements>
16        true
17    </enableEntitlements>    
18    <entitlementLookupLimitedToActiveStatus>
19        false
20    </entitlementLookupLimitedToActiveStatus>   
21    <entitlementLookupLimitedToSameAccount>
22        false
23    </entitlementLookupLimitedToSameAccount>   
24    <entitlementLookupLimitedToSameAsset>
25        false
26    </entitlementLookupLimitedToSameAsset>   
27    <entitlementLookupLimitedToSameContact>
28        false
29    </entitlementLookupLimitedToSameContact>
30</EntitlementSettings>

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.