---
schema_version: "1"
id: f5a82361a7731e93234481ec42c452cecdd217ba58e1c187d9da20379ef3288d
title: Custom Labels
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/cl_about.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.cl_about.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 53128c6e4a36938f40ce2417a09cd6ec6b28f35a36df6bd30c9434b842c1e216
description: Custom labels enable developers to create multilingual applications by automatically presenting information (for example, help text or error messages) in a user’s native language. Custom labels are custom text values that can be accessed from Apex classes, Visualforce pages, Lightning pages, or Lightning components. The values can be translated into any language Salesforce supports.
products:
  - Salesforce Platform
release: "264"
---
# Custom Labels

Custom labels enable developers to create multilingual applications by automatically presenting information (for example, help text or error messages) in a user’s native language. Custom labels are custom text values that can be accessed from Apex classes, Visualforce pages, Lightning pages, or Lightning components. The values can be translated into any language Salesforce supports.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: both Salesforce Classic and Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Developer</strong>, <strong>Professional</strong>, <strong>Enterprise</strong>, <strong>Performance</strong>, and <strong>Unlimited</strong> Editions</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
      <colgroup>
        <col style="width:50%">
        <col style="width:50%">
      </colgroup>
      <thead class="slds-text-title_caps ">
        <tr class="">
          <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d32734e73">User Permissions
            Needed</th>
        </tr>
      </thead>
      <tbody>
        <tr class="">
          <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d32734e73 ">Create, edit, or delete custom labels:</td>

          <td class="slds-cell-wrap" style="vertical-align:top;" headers="d32734e73 ">Customize Application</td>

        </tr>
        <tr class="">
          <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d32734e73 ">Create or override a translation:</td>

          <td class="slds-cell-wrap" style="vertical-align:top;" headers="d32734e73 ">
            <p>Manage Translation </p>
            <p>OR</p>
            <p style="margin-bottom:0;">View Setup and Configuration and be
              designated as a translator</p>
          </td>

        </tr>
      </tbody>
    </table>

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](https://appexchange.salesforce.com).

![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_code-264-0-0-production-enus/789bc523-706b-4ae4-8fe9-be6322e38b6b/images/icon_tip.png)

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

- **[Create and Edit Custom Labels](https://help.salesforce.com/s/articleView?id=platform.cl_edit.htm&release=264.0.0&type=5)**  
    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](https://help.salesforce.com/s/articleView?id=platform.cl_translate_edit.htm&release=264.0.0&type=5)**  
    Translations for custom labels determine what text to display for the label’s value when a user’s default language is the translation language.

#### See Also

- [Create and Edit Custom Labels](https://help.salesforce.com/s/articleView?id=platform.cl_edit.htm&release=264.0.0&type=5 "Create custom labels that can be referenced from Apex classes, Visualforce pages, Lightning pages, or Lightning components to make an app multilingual.")
- [_Lightning Aura Components Developer Guide_: Using Custom Labels](https://developer.salesforce.com/docs/atlas.en-us.lightning.meta/lightning/labels_value_provider_platform.htm)
- [_Lightning Web Components Developer Guide_: Access Labels](https://developer.salesforce.com/docs/component-library/documentation/en/lwc/create_labels)
- [_Apex Reference Guide_: Label Class](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_class_System_Label.htm)