---
schema_version: "1"
id: 2a564534b954c1415757a132f02e545ea3244fc7b6ab5930a68df3ef35e8aa87
title: Build Localized Component Labels and Attribute Values on Lightning Pages with Custom Labels
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/lightning_page_components_use_expressions_for_labels.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.lightning_page_components_use_expressions_for_labels.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 6f0a49f7d7692b88d6c5275b026d6c159f32ed733524bcd3e57ebf868af15661
description: When you specify labels or attributes in the Lightning App Builder such as for components, field section headers, or custom tabs, you can use the {!$Label.customLabelName} expression to help define the label or attribute’s value.
products:
  - Salesforce Platform
  - Security
release: "264"
---
# Build Localized Component Labels and Attribute Values on Lightning Pages with Custom Labels

When you specify labels or attributes in the Lightning App Builder such as for components, field section headers, or custom tabs, you can use the `{!$Label.customLabelName}` expression to help define the label or attribute’s value.

### 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;">Lightning App Builder available in: both Salesforce Classic and Lightning
              Experience</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Lightning Home pages available in: Lightning Experience</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Lightning app and record pages available in: both the Salesforce mobile app and
              Lightning Experience</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">
              <p style="margin-bottom:0;">Available in: <strong>Group</strong>
                <strong>Essentials</strong>, <strong>Professional</strong>, <strong>Enterprise</strong>, <strong>Performance</strong>,
                <strong>Unlimited</strong>, and <strong>Developer</strong> Editions
              </p>
            </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="d19623e103">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d19623e103 ">To create and save Lightning pages in the Lightning App Builder:</td>

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

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

On a Lightning page, custom Tabs component labels, field section header labels, and other component attribute values aren’t localized when they’re entered as plain text in the Lightning App Builder. For example, if you have an org whose default language is English, and you have a Tabs component with three custom tabs that you entered as Cars, Trucks, and Planes, the non-English users in your org see those tab label values as Cars, Trucks, and Planes when they view the page. The tab label values aren’t translated into your users’ languages.

But configuring custom label values in the Lightning App Builder using the `{!$Label.customLabelName}` expression lets users see labels in their chosen language if you created a translation for that label in their language.

The `{!$Label.customLabelName}` expression works with any custom labels that you create in Setup using the custom label feature. The text that you define in the Value field for your custom label displays as the label value when the component renders on a Lightning page. And, if you create a translated value for the label, users using that language in your org see the translated value.

Expressions are supported only in String type fields in component labels and attributes on app, Home, and record pages. You can’t use an expression in page-level properties.

1. Create a translated custom label in Setup.
    
    For more information, see [Translate Custom Labels](https://help.salesforce.com/articleView?id=cl_translate_edit.htm&language=en_US).
2. Navigate to the Lightning App Builder. From Setup, in the Quick Find box, enter App Builder, then select **Lightning App Builder**.
3. Open an app, record, or Home Lightning page.
4. Select the component whose label or property you want to replace with your translated custom label.
5. Enter `{!$Label.customLabelName}` in the label or attribute field, replacing “customLabelName” with the name of your custom label.
    
    Label and property fields that support using this expression have an info bubble that says so.
6. Save your changes.
    
    Users in your org whose language is set to the language of your translated label see the label or attribute in its translated value.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/images/icon_note.png)

Note When a field in a component contains an expression, Salesforce can’t validate the value it resolves to. If the expression resolves to a value that’s invalid for the field, sometimes the component doesn’t work as expected. We recommend that you test the page in the translated languages before you make the page with the expression available to users.

## Example: Create German Translation for Planes Tab

Your org's default language is English, but you want the custom Planes tab on your Lightning page to show a translated custom label for your German users.

1. Create a custom label in Setup with the name Planes\_Label, and enter the Value as Planes. That's what your English users see.
2. From the Translations related list on the custom label detail page, create a translation for the label with the language set to German and the Translation Text value as Flugzeuge.
3. Save the translation.
4. In the Lightning App Builder, open your page and click the Tabs component on the canvas.
5. In the properties pane, click the Planes tab, and in the Custom Label field, replace the Planes plain text with `{!$Label.Planes_Label}`.
    
    ![Using expressions in a tabset label](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/extend_click/images/lab_expressions_in_labels.png)
6. Click **Done** and save your page.

When viewing the page, your English users see the tab as Planes, and your German users see the tab as Flugzeuge.