Innovate anywhere, anytime Your cloud-based dev studio.

How to Use Custom Labels in Salesforce


Salesforce Custom labels are custom text values, which can be called from apex classes, visual force pages or lightning components. These text values can be translated into any language that Salesforce supports.

Custom labels can be used to create multilanguage applications, which are useful to translate information in user's native language.

Create a custom label:

Click on Setup --> Build --> Create --> Custom Label

In the new Custom Label enter the label description, categories(Text entered in this field can be used in filter criteria when creating Custom Label list views), mark the component as protected and value which is used to represent whenever this salesforce custom label is called upon in Apex or Visualforce pages.

When you click on Custom Label which is already created, you can find translations or else enable translation in Translation Workbench.

Create Translations:

Enter into the custom label to which you want to create translation.

Click on the new and select the language(languages that have been previously activated in the Translation Workbench, and languages that do not have a local translation or override already created) and provide the translation text.


The translation language should be added and make it active in the Translation workbench.

Whenever this selected language is called upon using language code and custom label in apex or visual force page it shows the text which we provided in salesforce custom label translation text

Syntax for custom label:

In Apex use System.Label.Labelname

In Visualforce page use {!$Label.Label_name}


We can create up to 5000 labels in an organization and they can be 1000 characters in length.

Custom Labels in managed packages doesn't come in count with the limit mentioned above.

salesforce Custom Label is called upon in an apex or visual force page so that the values mentioned on the custom label are returned as output. This text value can be changed by editing custom label and creating translation text with required language.

Whenever, language with its code like language="code" is called upon in an apex or visual force page along with salesforce custom label then the text value is represented in the specified language. So, by this way we can change the application into multilingual.