You are here:
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.
Required Editions
| Available in: both Salesforce Classic and Lightning Experience |
| Available in: Developer, Professional, Enterprise, Performance, and Unlimited Editions |
| User Permissions Needed | |
|---|---|
| Create, edit, or delete custom labels: | Customize Application |
| Create or override a translation: | Manage Translation OR View Setup and Configuration and be designated as a translator |
Note You can’t edit the attributes of custom labels installed as part of a managed package. You
can only override the existing translations or provide new translations for languages not
included in the package.
- From Setup, in the Quick Find box, enter Custom Labels, then select Custom Labels.
- To create a label, click New Custom Label. To edit a label, click Edit next to the custom label.
- In the Short Description field, enter an easily recognizable term to identify this custom label. This description is used in merge fields. You can’t change the language of an existing custom label.
- If you’re creating a custom label: In the Name field, enter the name the label uses. This value is 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.
- To mark the custom label as protected, select Protected Component.
- For Categories, enter text to categorize the label. This field can be used in filter criteria when creating custom label list views. Separate each category with a comma. The total number of characters allowed in the Categories text box is 255.
- In the Value text box, enter text up to 1,000 characters. This value can be translated into any language that Salesforce supports. It can take a few minutes before all users see changes you make to this field.
- Save the label.
Did this article solve your issue?
Let us know so we can improve!

