---
schema_version: "1"
id: d1d19382b272a50ab38b9bbd929e2465a171a19f629db9429d31af578ba110a6
title: ExternalStringLocalization
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_tooling/tooling_api_objects_externalstringlocalization.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/tooling_api_objects_externalstringlocalization.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: ef7f916235326e38fde662e83e53aa2d8babdc40391b1fab2beba8b2ba6c3c22
description: Represents the translation of custom labels for a UI component represented by the ExternalString object. This object is available in API version 49.0 and later.
---
# ExternalStringLocalization

Represents the translation of custom labels for a UI component represented by the [ExternalString](https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/tooling_api_objects_externalstring.htm "Represents a custom label for a translatable UI component. Includes access to the associated label in the Metadata API. Available in API version 38.0 and later.") object. This object is available in API version 49.0 and later.

## Supported SOAP API Calls

create(), delete(), describeSObjects(), query(), retrieve(), update(), upsert()

## Supported REST API HTTP Methods

DELETE, GET, PATCH, POST

## Special Access Rules

- Your organization must be using Professional, Enterprise, Performance, Unlimited, or Developer edition.
- Translation Workbench and data translation must be enabled in your org.
- To view this object, you must have the “View Setup and Configuration” permission.

## Limitations

[SOSL Limitations](https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/reference_objects_sosl_limits.htm "Two Tooling API objects, EntityDefinition and FieldDefinition, have some SOSL limitations. ExternalString and MetadataComponentDependency (Beta) don’t support SOSL searches.")

## Fields

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


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

              <th class="featureTableHeader  " id="d149046e147">Details</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d149046e144" data-title="Field"><span class="keyword parmname">ExternalStringId</span></td>

              <td class="entry" headers="d149046e147" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">reference</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Group, Sort</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The ID of the <a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/tooling_api_objects_externalstring.htm" title="Represents a custom label for a translatable UI component. Includes access to the associated label in the Metadata API. Available in API version 38.0 and later.">ExternalString</a> associated with the
                    custom label that is being translated.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d149046e144" data-title="Field"><span class="keyword parmname">Language</span></td>

              <td class="entry" headers="d149046e147" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">picklist</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Group, Restricted picklist, Sort</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The language for this translated text.<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_tooling.meta/api_tooling/images/icon_note.png" alt="Note">
                            <div class="mediaBd">
                              <h4 class="mbs">Note</h4>
                              <p>You can’t change the language of
                                an existing ExternalString.</p>
                            </div>
                          </div>
                        </div>
                      </div>
                    </div>
                  </dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d149046e144" data-title="Field"><span class="keyword parmname">ManageableState</span></td>

              <td class="entry" headers="d149046e147" data-title="Details">
                <div class="p">
                  <dl class="dl detailList">

                    <dt class="dt dlterm">Type</dt>

                    <dd class="dd">ManageableState enumerated list</dd>



                    <dt class="dt dlterm">Properties</dt>

                    <dd class="dd">Filter, Group, Nillable, Restricted picklist, Sort</dd>



                    <dt class="dt dlterm">Description</dt>

                    <dd class="dd">Indicates the manageable state of the specified component that is contained
                      in a package: <ul class="ul bulletList">
                        <li class="li"><samp class="codeph nolang">beta</samp></li>

                        <li class="li"><samp class="codeph nolang">deleted</samp></li>

                        <li class="li"><samp class="codeph nolang" id="d3938e233-d3965e373"><a name="d3938e233-d3965e373"><!-- --></a>deprecated</samp></li>

                        <li class="li"><samp class="codeph nolang">deprecatedEditable</samp></li>

                        <li class="li"><samp class="codeph nolang">installed</samp></li>

                        <li class="li"><samp class="codeph nolang">installedEditable</samp></li>

                        <li class="li"><samp class="codeph nolang">released</samp></li>

                        <li class="li"><samp class="codeph nolang">unmanaged</samp></li>

                      </ul>
                    </dd>


                  </dl>

                </div>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d149046e144" data-title="Field"><span class="keyword parmname">NamespacePrefix</span></td>

              <td class="entry" headers="d149046e147" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">string</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Filter, Group, Nillable, Sort</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The namespace of the package of which the custom label is a part.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d149046e144" data-title="Field"><span class="keyword parmname">Value</span></td>

              <td class="entry" headers="d149046e147" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">string</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Sort, Update</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The translated string value, limited to 32,000 characters or 96,000 bytes of
                    data, up to the length of the translated string.</dd>


                </dl>

              </td>

            </tr>

          </tbody>

        </table>