Custom Labels

You can create up to 5,000 custom labels for your organization, and they can be up to 1,000 characters in length. Custom labels from managed packages don’t count toward this limit.

To access custom labels, from Setup, enter Custom Labels in the Quick Find box, then select Custom Labels.

How you add a custom label to your application depends on the user interface. For more information on the following syntax, see the corresponding developer guides.

• In Apex use the System.Label.Label_name syntax. You can also use methods in the System.Label class to check for and retrieve translated labels. To check if translation exists for a label and language in a namespace, use translationExists(namespace, label, language). To retrieve the label for a default language setting or for a language and namespace, use get(namespace, label, language).
• In Flow Builder, use the $Label global variable.
• In Visualforce, use the $Label global variable.
• In Aura components, use the $Label.c.labelName syntax for the default namespace or $Label.namespace.labelName if your org has a namespace or to access a label in a managed package.
• In Lightning web components, import the label using the @salesforce/label/namespace.Label_name syntax.
• In Lightning App Builder component labels and attributes, use the {!$Label.customLabelName} expression.

Include the label in your application when you package it for the AppExchange.

Tip If a custom label has translations, include the translations in a package by explicitly packaging the desired languages.

• Create and Edit Custom Labels
  Create custom labels that can be referenced from Apex classes, Visualforce pages, Lightning pages, or Lightning components to make an app multilingual.
• Translate Custom Labels
  Translations for custom labels determine what text to display for the label’s value when a user’s default language is the translation language.