---
schema_version: "1"
id: 5fb7c11458ddb05a78de0bcf59e0593a2d80ba5d8c1fe83b4e9864f1998705b0
title: EntitlementSettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_entitlementsettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_entitlementsettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: edf16dc5b5172798b95f91f4e719d1983f8f105195fdaa7736128d850fd0559c
description: Represents an organization’s entitlement settings.
---
# EntitlementSettings

Represents an organization’s entitlement settings.

In the package manifest, all organization settings metadata types are accessed using the Settings name. See [Settings](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_settings.htm "Represents the organization settings related to a feature. For example, your password policies, session settings and network access controls are all available in the SecuritySettings component type.") for details.

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

EntitlementSettings is available in API version 27.0 and later.

## Fields

<table class="featureTable sort_table" summary="">



          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d437965e98">Field Name</th>

              <th class="featureTableHeader  " id="d437965e101">Field Type</th>

              <th class="featureTableHeader  " id="d437965e104">Description</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d437965e98" data-title="Field Name"><span class="keyword parmname">assetLookupLimitedToActiveEntitlementsOnAccount</span></td>

              <td class="entry" headers="d437965e101" data-title="Field Type">boolean</td>

              <td class="entry" headers="d437965e104" data-title="Description">Indicates whether entitlements-related lookup filters on cases
                return only the assets related to the active entitlements on the
                case’s account (<samp class="codeph java">true</samp>) or
                not (<samp class="codeph java">false</samp>).</td>

            </tr>

            <tr>
              <td class="entry" headers="d437965e98" data-title="Field Name"><span class="keyword parmname">assetLookupLimitedToActiveEntitlementsOnContact</span></td>

              <td class="entry" headers="d437965e101" data-title="Field Type">boolean</td>

              <td class="entry" headers="d437965e104" data-title="Description">Indicates whether entitlements-related lookup filters on cases
                return only the assets related to the active entitlements on the
                case’s contact (<samp class="codeph java">true</samp>) or
                not (<samp class="codeph java">false</samp>).</td>

            </tr>

            <tr>
              <td class="entry" headers="d437965e98" data-title="Field Name"><span class="keyword parmname">assetLookupLimitedToSameAccount</span></td>

              <td class="entry" headers="d437965e101" data-title="Field Type">boolean</td>

              <td class="entry" headers="d437965e104" data-title="Description">Indicates whether entitlements-related lookup filters on cases
                return only the assets related to the case’s account (<samp class="codeph java">true</samp>) or not (<samp class="codeph java">false</samp>).</td>

            </tr>

            <tr>
              <td class="entry" headers="d437965e98" data-title="Field Name"><span class="keyword parmname">assetLookupLimitedToSameContact</span></td>

              <td class="entry" headers="d437965e101" data-title="Field Type">boolean</td>

              <td class="entry" headers="d437965e104" data-title="Description">Indicates whether entitlements-related lookup filters on cases
                return only the assets related to the case’s contact (<samp class="codeph java">true</samp>) or not (<samp class="codeph java">false</samp>).</td>

            </tr>

            <tr>
              <td class="entry" headers="d437965e98" data-title="Field Name"><span class="keyword parmname">enableEntitlements</span></td>

              <td class="entry" headers="d437965e101" data-title="Field Type">boolean</td>

              <td class="entry" headers="d437965e104" data-title="Description">Indicates whether entitlements are enabled (<samp class="codeph java">true</samp>) or not (<samp class="codeph java">false</samp>).</td>

            </tr>

            <tr>
              <td class="entry" headers="d437965e98" data-title="Field Name"><span class="keyword parmname" id="EnableEntitlementVersionsName"><a name="EnableEntitlementVersionsName"><!-- --></a>enableEntitlementVersioning</span></td>

              <td class="entry" headers="d437965e101" data-title="Field Type">boolean</td>

              <td class="entry" headers="d437965e104" data-title="Description">
                <span class="ph" id="EnableEntitlementVersionsDef"><a name="EnableEntitlementVersionsDef"><!-- --></a>Indicates whether
                  entitlement versioning is enabled (<samp class="codeph java">true</samp>) or not (<samp class="codeph java">false</samp>).</span>
                <p class="p">This field is available in API
                  version 28.0 and later.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d437965e98" data-title="Field Name"><span class="keyword parmname">enableMilestoneFeedItem</span></td>

              <td class="entry" headers="d437965e101" data-title="Field Type">boolean</td>

              <td class="entry" headers="d437965e104" data-title="Description">When set to <samp class="codeph nolang">true</samp>, indicates
                whether to post to the feed and the record owner’s profile page when
                a milestone is completed or violated. When set to <samp class="codeph nolang">false</samp>, indicates that no post
                occurs when a milestone is completed or violated.<p class="p">This field is
                  available in API version 47.0 and later.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d437965e98" data-title="Field Name"><span class="keyword parmname">enableMilestoneStoppedTime</span></td>

              <td class="entry" headers="d437965e101" data-title="Field Type">boolean</td>

              <td class="entry" headers="d437965e104" data-title="Description">Indicates whether to show the <strong class="ph uicontrol">Stopped Time</strong>
                and <strong class="ph uicontrol">Actual Elapsed Time</strong> fields on an
                entitlement milestone (<samp class="codeph java">true</samp>) or
                not (<samp class="codeph nolang">false</samp>).<p class="p">This field is
                  available in API version 47.0 and later.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d437965e98" data-title="Field Name"><span class="keyword parmname">entitlementLookupLimitedToActiveStatus</span></td>

              <td class="entry" headers="d437965e101" data-title="Field Type">boolean</td>

              <td class="entry" headers="d437965e104" data-title="Description">Indicates whether entitlements-related lookup filters on cases
                return only active entitlements (<samp class="codeph java">true</samp>) or not (<samp class="codeph java">false</samp>).</td>

            </tr>

            <tr>
              <td class="entry" headers="d437965e98" data-title="Field Name"><span class="keyword parmname">entitlementLookupLimitedToSameAccount</span></td>

              <td class="entry" headers="d437965e101" data-title="Field Type">boolean</td>

              <td class="entry" headers="d437965e104" data-title="Description">Indicates whether entitlements-related lookup filters on cases
                return only the entitlements related to the case’s account
                (<samp class="codeph java">true</samp>) or not (<samp class="codeph java">false</samp>).</td>

            </tr>

            <tr>
              <td class="entry" headers="d437965e98" data-title="Field Name"><span class="keyword parmname">entitlementLookupLimitedToSameAsset</span></td>

              <td class="entry" headers="d437965e101" data-title="Field Type">boolean</td>

              <td class="entry" headers="d437965e104" data-title="Description">Indicates whether entitlements-related lookup filters on cases
                return only the entitlements related to the case’s asset
                (<samp class="codeph java">true</samp>) or not (<samp class="codeph java">false</samp>).</td>

            </tr>

            <tr>
              <td class="entry" headers="d437965e98" data-title="Field Name"><span class="keyword parmname">entitlementLookupLimitedToSameContact</span></td>

              <td class="entry" headers="d437965e101" data-title="Field Type">boolean</td>

              <td class="entry" headers="d437965e104" data-title="Description">Indicates whether entitlements-related lookup filters on cases
                return only the entitlements related to the case’s contact
                (<samp class="codeph java">true</samp>) or not (<samp class="codeph java">false</samp>).</td>

            </tr>

            <tr>
              <td class="entry" headers="d437965e98" data-title="Field Name"><span class="keyword parmname">ignoreMilestoneBusinessHours</span></td>

              <td class="entry" headers="d437965e101" data-title="Field Type">boolean</td>

              <td class="entry" headers="d437965e104" data-title="Description">Indicates whether to show the time remaining on an event
                milestone in actual hours (<samp class="codeph nolang">true</samp>) or business hours (<samp class="codeph nolang">false</samp>).<p class="p">This field is available in API version 47.0
                  and later.</p>
              </td>

            </tr>

          </tbody>

        </table>

## Declarative Metadata Sample Definition

This is a sample entitlements settings file.

<?xml version="1.0" encoding="UTF-8"?>
<EntitlementSettings xmlns="http://soap.sforce.com/2006/04/metadata">   
    <assetLookupLimitedToActiveEntitlementsOnAccount\>
        false
    </assetLookupLimitedToActiveEntitlementsOnAccount\>   
    <assetLookupLimitedToActiveEntitlementsOnContact\>
        false
    </assetLookupLimitedToActiveEntitlementsOnContact\>   
    <assetLookupLimitedToSameAccount\>
        false
    </assetLookupLimitedToSameAccount\>   
    <assetLookupLimitedToSameContact\>
        false
    </assetLookupLimitedToSameContact\>   
    <enableEntitlements\>
        true
    </enableEntitlements\>    
    <entitlementLookupLimitedToActiveStatus\>
        false
    </entitlementLookupLimitedToActiveStatus\>   
    <entitlementLookupLimitedToSameAccount\>
        false
    </entitlementLookupLimitedToSameAccount\>   
    <entitlementLookupLimitedToSameAsset\>
        false
    </entitlementLookupLimitedToSameAsset\>   
    <entitlementLookupLimitedToSameContact\>
        false
    </entitlementLookupLimitedToSameContact\>
</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](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/meta_settings.htm). 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).