---
schema_version: "1"
id: 5d671c12bcd83a550f0211d274472ce437f3fa90fe8331bf93e7b2e7f30e9688
title: OrgPreferenceSettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_orgpreferencesettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_orgpreferencesettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 90ae016b8505a704696dca7e60a0726871e5aa720d475de805165aff0bcb8b19
description: Removed in API version 48.0. Represents the unique org preference settings in a Salesforce org.
---
# OrgPreferenceSettings

Removed in API version 48.0. Represents the unique org preference settings in a Salesforce org.

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.

## File Suffix and Directory Location

OrgPreferenceSettings values are stored in the OrgPreference.settings file in the settings directory. The .settings files are different from other named components because there is only one settings file for each settings component.

## Version

OrgPreferenceSettings components are available in API versions 37.0 to 47.0.

OrgPreferenceSettings is deprecated in API version 47.0 and removed in API version 48.0. In API version 47.0, most of the settings supported in the preferences field were made available in the form of Boolean fields on other Settings types. For example, in API version 47.0 and later, you can enable and disable the CompileOnDeploy preference by using the enableCompileOnDeploy field on the ApexSettings type.

## Fields

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



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

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

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

            </tr>

          </thead>

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

              <td class="entry" headers="d725110e114" data-title="Field Type">
                <a class="xref" href="#organizationsettingsdetail">OrganizationSettingsDetail</a>[]
              </td>

              <td class="entry" headers="d725110e117" data-title="Description">The preferences associated with the org settings. In the
                following list of preferences, click hyperlinked preference names to
                go to the topic for the Settings type that contains that preference.
                If there is no link, the preference hasn’t been moved to another
                Settings type.<ul class="ul bulletList">
                  <li class="li">
                    <a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_analyticssettings.htm" title="Represents Analytics settings in Salesforce. CRM Analytics lets you explore all your data quickly and easily by providing AI-powered advanced Analytics right inside Salesforce. Manage your datasets, query data with Salesforce Analytics Query Language (SAQL), and customize dashboards. You can use these settings to configure which Analytics features are available to users in your organization."><samp class="codeph nolang">AnalyticsSharingEnable</samp></a> (available
                    in API version 40.0 and later)
                  </li>

                  <li class="li"><samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_apexsettings.htm#ops_apexlockunlock">ApexApprovalLockUnlock</a></samp></li>

                  <li class="li">
                    <samp class="codeph nolang">AsyncSaveEnabled</samp>
                    (available in API versions 40.0 to 46.0)
                  </li>

                  <li class="li"><samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_chattersettings.htm#ops_chatter">ChatterEnabled</a></samp></li>

                  <li class="li">
                    <samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_apexsettings.htm#ops_compileondeploy">CompileOnDeploy</a></samp>
                    (available in API version 43.0 and later)
                  </li>

                  <li class="li">
                    <samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_partydatamodelsettings.htm" title="Represents an organization’s party data model settings, including options around the Individual object and consent enablement. This type extends the Metadata metadata type and inherits its fullName field.">ConsentManagementEnabled</a></samp>
                    (available
                    in API version 45.0 and later)
                  </li>

                  <li class="li"><samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_emailadministrationsettings.htm#ops_enhancedemail">EnhancedEmailEnabled</a></samp></li>

                  <li class="li"><samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_eventsettings.htm#ops_eventlogwave">EventLogWaveIntegEnabled</a></samp></li>

                  <li class="li"><samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_eventsettings.htm#ops_loginforensics">LoginForensicsEnabled</a></samp></li>

                  <li class="li">
                    <a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_communitiessettings.htm" title="Represents community settings for an org. Enable digital experiences and workspaces. Manage moderation, guest user and partner settings, and more. This type extends the Metadata metadata type and inherits its fullName field."><samp class="codeph nolang">NetworksEnabled</samp></a> (available in API
                    version 40.0 and later)
                  </li>

                  <li class="li"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_enhancednotessettings.htm" title="Represents an org’s enhanced note settings, such as enabling enhanced notes and enabling tasks in enhanced notes.This type extends the Metadata metadata type and inherits its fullName field."><samp class="codeph nolang">NotesReservedPref01</samp></a></li>

                  <li class="li"><samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_mobilesettings.htm#ops_offlinedrafts">OfflineDraftsEnabled</a></samp></li>

                  <li class="li"><samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_pathassistantsettings.htm#ops_pathassistant">PathAssistantsEnabled</a></samp></li>

                  <li class="li">
                    <samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_lightningexperiencesettings.htm#ops_lightningexp">S1DesktopEnabled</a></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>After it is enabled, <samp class="codeph nolang">S1DesktopEnabled</samp> can’t be disabled in any
                                version of the API.</p>
                            </div>
                          </div>
                        </div>
                      </div>
                    </div>
                  </li>

                  <li class="li"><samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_mobilesettings.htm#ops_encryptedstoragepref2">S1EncryptedStoragePref2</a></samp></li>

                  <li class="li"><samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_mobilesettings.htm#ops_s1offlinepref">S1OfflinePref</a></samp></li>

                  <li class="li">
                    <samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_devhubsettings.htm#ops_scratchorgmanagementpref">ScratchOrgManagementPref</a></samp> (available
                    in API version 41.0 and later)
                  </li>

                  <li class="li"><samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_emailadministrationsettings.htm#ops_sendviagmail">SendThroughGmailPref</a></samp></li>

                  <li class="li"><samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_socialprofilesettings.htm#ops_socialprofiles">SocialProfilesEnable</a></samp></li>

                  <li class="li">
                    <samp class="codeph nolang"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_languagesettings.htm" title="Represents an organization’s language settings. Language settings control end-user language selection, locale formats, and translation options. This type extends the Metadata metadata type and inherits its fullName field.">Translation</a></samp> (available in API
                    version 40.0 and later)
                  </li>

                  <li class="li">
                    <samp class="codeph nolang">VoiceEnabled</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>The
                                <samp class="codeph nolang">VoiceEnabled</samp>
                                preference isn’t being moved to another metadata type.
                                If you want to use it in a scratch org in API version
                                48.0 and later, you can enable it as a scratch org
                                feature.
                              </p>
                            </div>
                          </div>
                        </div>
                      </div>
                    </div>
                  </li>

                </ul>
              </td>

            </tr>

          </tbody>

        </table>

## OrganizationSettingsDetail

| Field Name | Field Type | Description |
| --- | --- | --- |
| settingName | string | The name of the setting. For example, “S1EncryptedStoragePref2.” |
| settingValue | boolean | Indicates whether the setting is enabled (true) or not (false). |

## Declarative Metadata Sample Definition

The following is an example of a OrgPreferenceSettings component. The example shows only the preferences values that are supported but not yet available as fields on another Settings type in API version 47.0.

<?xml version="1.0" encoding="UTF-8"?>
<OrgPreferenceSettings xmlns="http://soap.sforce.com/2006/04/metadata">
    <preferences\>
        <settingName\>AnalyticsSharingEnable</settingName\>
        <settingValue\>true</settingValue\>
    </preferences\>
    <preferences\>
        <settingName\>NetworksEnabled</settingName\>
        <settingValue\>true</settingValue\>
    </preferences\>
    <preferences\>
        <settingName\>NotesReservedPref01</settingName\>
        <settingValue\>false</settingValue\>
    </preferences\>
    <preferences\>
        <settingName\>ScratchOrgManagementPref</settingName\>
        <settingValue\>true</settingValue\>
    </preferences\>
    <preferences\>
        <settingName\>VoiceEnabled</settingName\>
        <settingValue\>false</settingValue\>
    </preferences\>
</OrgPreferenceSettings\>

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