---
schema_version: "1"
id: 9b1fa52583aacd494872e06b810a058ab936848e9b2a733f26ae24c10b0ab201
title: LanguageSettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_languagesettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_languagesettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 30dcff51f29d414899e2b5e598846f2c5fb4e065305acc4f99b8d5ab5e79b6aa
description: 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.
---
# LanguageSettings

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.

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

LanguageSettings values are stored in the Language.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

LanguageSettings is available in API version 47.0 and later.

## Fields

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



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

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

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

            </tr>

          </thead>

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

              <td class="entry" headers="d605244e106" data-title="Field Type">string</td>

              <td class="entry" headers="d605244e109" data-title="Description"> A comma-separated list of Salesforce language locale codes to
                display, such as <samp class="codeph nolang">en_US, fr, de,
                  ja</samp>. The order of the codes determines the order in
                which languages appear in the list, matching the language order
                setting in the UI. Specify <samp class="codeph nolang">all</samp>
                to display all languages available to the org. If omitted, the
                existing configuration doesn't change. This field is available in
                API version 68.0 and later.</td>

            </tr>

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

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

              <td class="entry" headers="d605244e109" data-title="Description">Indicates whether the ICU format is enabled for the en_CA locale
                (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). This field has a default
                value of <samp class="codeph nolang">true</samp> for orgs created
                in API version 47.0 and later. Orgs created prior to API version
                47.0 have a default of <samp class="codeph nolang">false</samp>.</td>

            </tr>

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

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

              <td class="entry" headers="d605244e109" data-title="Description">Indicates whether data translation is enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). This field has a default
                value of <samp class="codeph nolang">false</samp>. This field is
                available in API version 49.0 and later.</td>

            </tr>

            <tr>
              <td class="entry" headers="d605244e103" data-title="Field Name"><span class="ph" id="enableEndUserLanguages"><a name="enableEndUserLanguages"><!-- --></a><span class="keyword parmname">enableEndUserLanguages</span></span></td>

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

              <td class="entry" headers="d605244e109" data-title="Description">Indicates whether end-user languages are enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). This field has a default
                value of <samp class="codeph nolang">false</samp>.</td>

            </tr>

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

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

              <td class="entry" headers="d605244e109" data-title="Description">Indicates whether date and currency are formatted with the
                International Components for Unicode (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). This field has a default value of <samp class="codeph nolang">true</samp> for orgs created in API
                version 47.0 and later. Orgs created prior to API version 47.0 have
                a default of <samp class="codeph nolang">false</samp>. <p class="p">See
                  <a class="xref" href="https://help.salesforce.com/articleView?id=icu_migration_overview.htm&amp;language=en_US" target="_blank" title="HTML (New Window)">Go
                    Global with New International Locale Formats</a> for more
                  information.
                </p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d605244e103" data-title="Field Name"><span class="keyword parmname">enableLanguageExtensionPackage
                  (beta)</span></td>

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

              <td class="entry" headers="d605244e109" data-title="Description">Indicates whether the org has enabled language extension packages
                (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). Language extension packages
                contain translations of components in other packages. This field has
                a default value of <samp class="codeph nolang">false</samp>. This
                field is available in API version 58.0 and later.<div class="p">
                  <div class="box message info" id="note_x3f_233_tdc">
                    <a name="note_x3f_233_tdc"><!-- --></a>
                    <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>enableLanguageExtensionPackage
                              (beta) is a pilot or beta service that is subject to the
                              Beta Services Terms at <a class="xref" href="https://www.salesforce.com/company/legal/agreements/" target="_blank">Agreements -
                                Salesforce.com</a> or a written Unified Pilot
                              Agreement if executed by Customer, and applicable terms in
                              the <a class="xref" href="https://ptd.salesforce.com/" target="_blank">Product Terms Directory</a>. Use of
                              this pilot or beta service is at the Customer's sole
                              discretion.</p>
                          </div>
                        </div>
                      </div>
                    </div>
                  </div>

                </div>
              </td>

            </tr>

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

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

              <td class="entry" headers="d605244e109" data-title="Description">Indicates whether users can filter query results, regardless of
                the locale or language associated with the user (<samp class="codeph nolang">true</samp>) or if they can’t filter
                results (<samp class="codeph nolang">false</samp>). This field has
                a default value of <samp class="codeph nolang">false</samp>. This
                field is available in API version 56.0 and later.</td>

            </tr>

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

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

              <td class="entry" headers="d605244e109" data-title="Description">Indicates whether local name fields can be defined for standard
                objects (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). This field has a default
                value of <samp class="codeph nolang">false</samp>. This field is
                available in API version 48.0 and later.</td>

            </tr>

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

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

              <td class="entry" headers="d605244e109" data-title="Description">Indicates whether platform-only languages are enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). This field has a default
                value of <samp class="codeph nolang">false</samp>. Setting this
                field to <samp class="codeph nolang">true</samp> also sets
                <span class="keyword parmname">enableEndUserLanguages</span><samp class="codeph nolang">true</samp>.
              </td>

            </tr>

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

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

              <td class="entry" headers="d605244e109" data-title="Description">Indicates whether the Translation Workbench is enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). This field has a default
                value of <samp class="codeph nolang">false</samp>.</td>

            </tr>

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

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

              <td class="entry" headers="d605244e109" data-title="Description">Indicates whether the Translation Workbench Connect REST API is
                enabled (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). This field has a default
                value of <samp class="codeph nolang">false</samp>. This field is
                available in API version 67.0 and later</td>

            </tr>

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

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

              <td class="entry" headers="d605244e109" data-title="Description">Indicates whether translation follows the language fallback rule
                (<samp class="codeph nolang">true</samp>) or returns the
                primary label (<samp class="codeph nolang">false</samp>). This
                field has a default value of <samp class="codeph nolang">true</samp>.</td>

            </tr>

          </tbody>

        </table>

## Declarative Metadata Sample Definition

The following is an example of a LanguageSettings file.

<?xml version="1.0" encoding="UTF-8"?>
<LanguageSettings xmlns="http://soap.sforce.com/2006/04/metadata">
    <displayedLanguages\>en\_US,fr,de,ja</displayedLanguages\>
    <enableCanadaIcuFormat\>true</enableCanadaIcuFormat\>
    <enableDataTranslation\>false</enableDataTranslation\>
    <enableEndUserLanguages\>true</enableEndUserLanguages\>
    <enableICULocaleDateFormat\>true</enableICULocaleDateFormat\>
    <enableLocalNamesForStdObjects\>false</enableLocalNamesForStdObjects\>
    <enablePlatformLanguages\>false</enablePlatformLanguages\>
    <enableTranslationWorkbench\>true</enableTranslationWorkbench\>
    <useLanguageFallback\>true</useLanguageFallback\>
</LanguageSettings\>

The following is an example package.xml that references the previous definition.

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