---
schema_version: "1"
id: b7acfcd7adc89f046e20f33da3839b47aa5c471d06bb5ca8f8c6e17227cb33af
title: UserInterfaceSettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_userinterfacesettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_userinterfacesettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 211e097bb3d9962443374cbe61331b01224d62e9b297c3ef138598c0005785c3
description: Represents the settings that modify the behavior of the org’s user interface.
---
# UserInterfaceSettings

Represents the settings that modify the behavior of the org’s user interface.

## Parent Type and Manifest Access

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.

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

A UserInterfaceSettings component file has the suffix .settings and is stored 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

UserInterfaceSettings components are available in API version 46.0 and later.

## Fields

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



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

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

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

            </tr>

          </thead>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether users can create custom actions for their Recently Viewed
                lists (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default is <samp class="codeph nolang">true</samp>. Available in API version 52.0 and later. Applies to Lightning
                Experience only.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether related lists are loaded asynchronously (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default is <samp class="codeph nolang">false</samp>.
                Available in API version 47.0 and later. Salesforce Classic only.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether a Visualforce page that hides the standard header has
                clickjack protections (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default is <samp class="codeph nolang">true</samp>. This setting applies to all of your Visualforce pages.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether users are allowed to collapse or expand sections in record
                details by using the arrow icon next to the section heading. The default is <samp class="codeph nolang">true</samp>.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether users are allowed to show or hide the sidebar on every page
                that normally includes it (<samp class="codeph nolang">true</samp>) or not
                (<samp class="codeph nolang">false</samp>). The default is <samp class="codeph nolang">false</samp>. Applies to Salesforce Classic only.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether users with Customize Application permission can truncate
                custom objects (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). When you truncate an object, you delete the
                object’s associated records permanently, while preserving the empty object and its
                metadata. The default is <samp class="codeph nolang">false</samp>. Available in
                API version 47.0 and later.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether custom sidebar components are available on all pages for all
                org users (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default is <samp class="codeph nolang">false</samp>. Applies to Salesforce Classic only.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether users can delete field history and field history archive
                records (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default is <samp class="codeph nolang">false</samp>. Available in API version 47.0 and later.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether related lists of external objects are loaded asynchronously (
                <samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default is <samp class="codeph nolang">true</samp>.
                Available in API version 48.0 and later. Salesforce Classic only.
              </td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether an interactive overlay containing record details is displayed
                (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default is <samp class="codeph nolang">true</samp>.<div class="box message info">
                  <div class="inner">
                    <div class="bd">
                      <div class="media">
                        <img class="img mtm" src="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note.png" alt="Note">
                        <div class="mediaBd">
                          <h4 class="mbs">Note</h4>
                          <p>To view hover details for a record, users need the
                            appropriate sharing access and field-level security access for the fields in the
                            mini page layout.</p>
                        </div>
                      </div>
                    </div>
                  </div>
                </div>
              </td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether users are allowed to edit field values on a record’s detail
                page (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default is <samp class="codeph nolang">true</samp>.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether users can install and use personal canvas apps <samp class="codeph nolang">(true)</samp> or not <samp class="codeph nolang">(false)</samp>. The default is <samp class="codeph nolang">true</samp>. This
                setting applies to all of your Visualforce pages.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether related list hover links display at the top of record detail
                pages and custom object detail pages in Setup (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). Users can
                hover over a related list link to display the list and its number of records in an
                interactive overlay. Users quickly view and manage the related list items from the
                overlay. Users can also click a related list hover link to jump to the related list
                without having to scroll down the page. The default is <samp class="codeph nolang">true</samp>. Available in API version 50.0 and later.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether individual users can enable dark mode (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>) for the Salesforce Cosmos theme. The default value is <samp class="codeph nolang">false</samp>. Available for SLDS 2 themes in select
                editions. See <a class="xref" href="https://help.salesforce.com/s/articleView?id=xcloud.customize_ui_enhancedlex.htm&amp;type=5&amp;language=en_US" target="_blank">Salesforce Cosmos Theme and SLDS 2
                  Availability</a>. Available in API version 65.0 and later.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether an area displays on a tab home page (corresponds to the
                <strong class="ph uicontrol">Show Quick Create</strong> setting), allowing users to create a
                record quickly with minimal information (<samp class="codeph nolang">true</samp>)
                or not (<samp class="codeph nolang">false</samp>). The Quick Create area displays
                by default on the tab home pages for leads, accounts, contacts, and opportunities.
                You can control whether the Quick Create area is displayed on all relevant tab home
                pages.
              </td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether users can inline edit any field they have edit access to in
                list views, regardless of page layout restrictions (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default
                is <samp class="codeph nolang">false</samp>. Available in API version 68.0 and
                later. Applies to Lightning Experience only.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether users can inline edit fields in list views that contain
                records of more than one record type (<samp class="codeph nolang">true</samp>) or
                not (<samp class="codeph nolang">false</samp>). The default is <samp class="codeph nolang">false</samp>. Available in API version 68.0 and later.
                Applies to Lightning Experience only. Inline editing with multiple record types
                applies to list views rendered with Lightning Web Components (LWC).</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether users can sort list views by multiple columns (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default is <samp class="codeph nolang">true</samp>.
                Available in API version 63.0 and later.</td>

            </tr>

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

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

              <td class="entry" headers="d943687e121" data-title="Description">Indicates whether users can sort related lists by multiple columns (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The default is <samp class="codeph nolang">true</samp>.
                Available in API version 63.0 and later.</td>

            </tr>

          </tbody>

        </table>

## Declarative Metadata Sample Definition

The following is an example of a UserInterfaceSettings component.

<?xml version="1.0" encoding="UTF-8"?>
<UserInterfaceSettings xmlns="http://soap.sforce.com/2006/04/metadata">
  <enableDeleteFieldHistory\>false</enableDeleteFieldHistory\>
  <enableInlineEdit\>true</enableInlineEdit\>
  <enableHoverDetails\>false</enableHoverDetails\>
  <enableQuickCreate\>true</enableQuickCreate\>
  <enablePersonalCanvas\>false</enablePersonalCanvas\>
  <enableClickjackUserPageHeaderless\>true</enableClickjackUserPageHeaderless\>
</UserInterfaceSettings\>

## Example Package Manifest

The following is an example package manifest used to deploy or retrieve the user interface settings metadata for an organization:

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
	<types\>
		<members\>UserInterface</members\>
		<name\>Settings</name\>
	</types\>
	<version\>46.0</version\>
</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](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).