LightningExperienceSettings

Represents the settings that modify an org’s Lightning Experience configuration.

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

This type extends Metadata and inherits its fields.

A LightningExperienceSettings component has the suffix .settings and is stored in the settings folder. The .settings files are different from other named components because there is only one settings file for each settings component.

Introduced in API version 47.0.

• Type: string
• Required: No
• Description: If specified, indicates the API name of the custom LightningExperienceTheme that’s currently active in the org. If the field isn’t specified, then the org uses one of the built-in themes that Salesforce provides. Custom themes are available in API version 48.0 and later.

• Type: boolean
• Required: No
• Version: Deprecated in API version 47.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No
• Version: Deprecated in API version 48.0 and later because the feature is no longer available.
• Description: This field corresponds to the API Only Users Can Access Only Salesforce APIs critical update, which was enforced in Spring ’20. If a user has the API Only User permission, they can access Salesforce only via APIs, regardless of their other permissions. This restriction already applied to other Salesforce features, but the critical update enforced the restriction in Lightning Out also.

• Type: boolean

• Required: No

• Description: If true, dynamic boxcar optimization for the Aura framework is disabled. With dynamic boxcar optimization, a limited number of server-side Aura actions are grouped in a single network request, which improves the performance of Lightning components and apps. For more information, see Boxcar Grouping and Optimization in the Lightning Aura Components Developer Guide.

  The default value is false.

• Type: boolean
• Required: No
• Description: Indicates whether Lightning Experience and other apps use a content delivery network (CDN) to serve the static content for Lightning Component framework. A CDN generally speeds up page load time, but it also changes the source domain that serves the files. If your company has IP range restrictions for content served from Salesforce, test thoroughly before enabling this setting. The default is true.

• Type: boolean
• Required: No
• Version: Removed in API version 51.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No
• Version: Removed in API version 68.0 and later because the Enable Secure Static Resources for Lightning Components release update was cancelled.
• Description: In Summer ’26 and later, all static resources are served automatically from the lightning domain, regardless of the API version.

• Type: boolean
• Required: No
• Introduced: API version 64.0
• Description: Indicates whether the “Defer loading inactive console workspace pages” setting is enabled (true) or not (false). The default value is true. See Defer Loading Inactive Lightning Console Workspace Pages in Salesforce Help.

• Type: boolean
• Required: No
• Description: Reserved for future use.

• Type: boolean
• Required: No
• Description: Indicates whether users can send feedback to Salesforce from the mobile app. The default is false.

• Type: boolean
• Required: No
• Description: Reserved. Do not use.

• Type: boolean
• Required: No

• Type: boolean
• Required: No
• Version: Deprecated in API version 47.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No
• Version: Deprecated in API version 47.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No
• Introduced: API version 54.0
• Description: Indicates whether Learning Paths is enabled (true) or not (false). The default is true. If false, you can’t assign learning items to users, and users can’t view assigned learning items in the Guidance Center or access Learning Home. See Learning Paths in Salesforce Help.

• Type: boolean
• Required: No
• Description: Indicates whether users see onboarding tips in the mobile app. The default is false.

• Type: boolean
• Required: No
• Description: Indicates whether Salesforce Classic is turned off for your org (true) or not (false). Removes the Switcher for all users in the org. The default is false. See Turn Off Salesforce Classic for Your Org in Salesforce Help. This field is similar to enableUsersAreLightningOnly. If either field is set to true, users are blocked from switching to Salesforce Classic.

• Type: boolean
• Required: No

• Type: boolean
• Required: No

• Type: boolean
• Required: No

• Type: boolean
• Required: No

• Type: boolean
• Required: No

• Type: boolean
• Required: No

• Type: boolean
• Required: No

• Type: boolean
• Required: No
• Description: Indicates whether Lightning Experience is turned on for iPad Browsers (true) or not (false). The default is false. See Give Users Access to Lightning Experience on iPad Browsers (Beta) in Salesforce Help.

• Type: boolean
• Required: No

• Type: boolean
• Required: No

• Type: boolean
• Required: No
• Introduced: API version 62.0
• Description: Indicates whether Local Dev is turned on for your org (true) or not (false). The default value is false. See Preview Components with Local Dev in Salesforce Developers.

• Type: boolean
• Required: No
• Description: Indicates whether users are blocked from personalizing the Lightning Experience navigation bar (true) or not (false). The default is false (that is, users can personalize the navigation bar by default). Salesforce recommends disabling personalization at the app level, not the org level. See Configure User Interface Settings in Salesforce Help.

• Type: boolean
• Required: No
• Description: Indicates whether consecutive API navigation calls in Visualforce pages are allowed (false) or blocked (true). The default is false.

• Type: boolean
• Required: No
• Introduced: API version 51.0
• Description: Indicates whether Quip is available for your org.

• Type: boolean
• Required: No
• Version: Deprecated in API version 47.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No
• Version: Deprecated in API version 47.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No
• Description: Indicates whether all users can access the Salesforce mobile web view from a supported mobile browser (true) or not (false). If false, then users must access the Salesforce mobile full site view from a mobile browser. Full site view doesn’t have the full functionality of mobile web view. Salesforce Classic and Lightning Experience aren’t supported on mobile browsers.

• Type: boolean
• Required: No
• Description: Indicates whether Lightning Experience is turned on in the org (true) or not (false). After it’s enabled, this setting can’t be disabled via the user interface or the API. See Turn on Lightning Experience for Your Org in Salesforce Help.

• Type: boolean
• Required: No
• Version: Deprecated in API version 47.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No

• Type: boolean
• Required: No
• Description: Reserved for internal use.

• Type: boolean
• Required: No
• Version: Deprecated in API version 50.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No
• Version: Deprecated in API version 50.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No
• Version: Deprecated in API version 50.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No
• Version: Removed in API version 52.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No
• Introduced: API version 61.0
• Description: Indicates whether the Enable LWC Stacked Modals release update is enabled (true) or not (false). For orgs created before Summer ’24, the default value is false. For orgs created in Summer ’24 and later, the default value is true.

• Type: boolean
• Required: No
• Description: Indicates whether the Try Lightning Experience Now prompt is hidden from users (true) or not (false). The default is false. See Try Lightning Experience Now Prompt in Salesforce Help.

• Type: boolean
• Required: No
• Description: Indicates whether Salesforce Classic is turned off for your org (true) or not (false). Removes the Switcher for all users in the org. The default is false. This field is similar to enableLexEndUsersNoSwitching. If either field is set to true, users are blocked from switching to Salesforce Classic.

• Type: boolean
• Required: No
• Version: Deprecated in API version 47.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No
• Version: Deprecated in API version 50.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No
• Version: Deprecated in API version 50.0 and later because the feature is no longer available.
• Description:

• Type: boolean
• Required: No
• Introduced: API version 48.0
• Description: Indicates whether all users can enable the Lightning Extension Component Customization feature. If false, the feature is disabled for all users, even users who had it enabled. See Try New Features with the Lightning Extension for Chrome.

• Type: boolean
• Required: No
• Introduced: API version 48.0
• Description: Indicates whether all users can enable the Lightning Extension Dark Mode feature. If false, the feature is disabled for all users, even users who had it enabled.

• Type: boolean
• Required: No
• Introduced: API version 48.0
• Description: Indicates whether all users can enable the Lightning Extension Link Grabber feature. If false, the feature is disabled for all users, even users who had it enabled.

• Type: boolean
• Required: No
• Introduced: API version 48.0
• Description: Indicates whether all users can enable the Lightning Extension for your org. If false, your users can’t enable the Lightning Extension, even if they already have it installed.

The following is an example of a LightningExperienceSettings component.

1<?xml version="1.0" encoding="UTF-8"?>
2<LightningExperienceSettings xmlns="http://soap.sforce.com/2006/04/metadata">
3
4    <enableAuraCDNPref>true</enableAuraCDNPref>
5    <enableFeedbackInMobile>true</enableFeedbackInMobile>
6    <enableInAppTooltips>true</enableInAppTooltips>
7    <enableLEXOnIpadEnabled>true</enableLEXOnIpadEnabled>
8    <enableLexEndUsersNoSwitching>true</enableLexEndUsersNoSwitching>
9    <enableNavPersonalizationOptOut>true</enableNavPersonalizationOptOut>
10    <enableS1BrowserEnabled>false</enableS1BrowserEnabled>
11    <enableS1DesktopEnabled>true</enableS1DesktopEnabled>
12    <enableTryLightningOptOut>true</enableTryLightningOptOut>
13    <enableUsersAreLightningOnly>true</enableUsersAreLightningOnly>
14</LightningExperienceSettings>

The following is an example package.xml 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>LightningExperience</members>
5        <name>Settings</name>
6    </types>
7    <version>47.0</version>
8</Package>

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.