---
schema_version: "1"
id: 8113cba46aa4ce4f6ef9e79d3687d82535d7fe0b28e4c623a3326b1f66e96e84
title: ExternalString
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_tooling/tooling_api_objects_externalstring.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/tooling_api_objects_externalstring.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: acd3790f8cd024b89d9bdfdb010116cb31731aef3731f827834d01ba0b00c7de
description: 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

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.

## Supported SOAP Calls

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

## Supported REST HTTP Methods

DELETE, GET, PATCH, POST

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

| Field | Details |
| --- | --- |
| Category | 
Type

string

Properties

Create, Filter, Group, Nillable, Sort, Update

Description

Text that categorizes the label, limited to 255 characters. Separate each category with a comma. This field can be used in filter criteria when creating custom label list views.



 |
| IsProtected | 

Type

boolean

Properties

Create, Defaulted on create, Filter, Group, Sort, Update

Description

Indicates whether the custom label is protected (true) or not (false). The default value is false .



 |
| Language | 

Type

picklist

Properties

Create, Defaulted on create, Filter, Group, Restricted picklist, Sort

Description

The language of the custom label.

![Note](https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/images/icon_note.png)

#### Note

You can’t change the language of an existing custom label.















 |
| ManageableState | 

Type

ManageableState enumerated list

Properties

Filter, Group, Nillable, Restricted picklist, Sort

Description

Indicates the manageable state of the specified component that is contained in a package:

- beta
- deleted
- deprecated
- deprecatedEditable
- installed
- installedEditable
- released
- unmanaged





 |
| MasterLabel | 

Type

string

Properties

Create, Filter, Group, Sort, Update

Description

An easily recognizable internal label to identify this custom label. This description is used in merge fields and is not translated.



 |
| Name | 

Type

string

Properties

Create, Filter, Group, Sort

Description

The name used in Apex and Visualforce pages to reference the custom label. Names must contain only alphanumeric characters, start with a letter, contain no spaces or double underscores, and be unique from all other labels in your org.



 |
| NamespacePrefix | 

Type

string

Properties

Filter, Group, Nillable, Sort

Description

The namespace of the package of which the custom label is a part.



 |
| Value | 

Type

string

Properties

Create, Filter, Sort, Update

Description

The custom label value, limited to 1,000 characters. This value can be translated into any language that Salesforce supports.



 |