---
schema_version: "1"
id: 328a6a963f544a8afe9a02e05fb3eac0691efdb44100ac617337d64dafd3c9e4
title: Using Custom Labels
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/aura-platform/guides/aura/labels/labels-value-provider-platform.md
canonical_url: https://developer.salesforce.com/docs/platform/aura-platform/guide/labels-value-provider-platform.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 0940d594213f79d953393c0af05986bca2606926a11486b985e06ec13d122342
products:
  - Lightning Aura Components Developer Guide
  - Platform Developer Content
---

# Using Custom Labels

Custom labels are custom text values that can be translated into any language that Salesforce supports. To access custom labels in Aura components, use the `$Label` global value provider.

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.

**note:** Label translations require the Translation Workbench is enabled.

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

Use the following syntax to access custom labels in Aura components.

-   `$Label.c.labelName` for the default namespace
-   `$Label.namespace.labelName` if your org has a namespace, or to access a label in a managed package

You can reference custom labels in component markup and in JavaScript code. Here are some examples.

## Label in a markup expression using the default namespace

`{!$Label.c.labelName}`

**note:** Label expressions in markup are supported in `.cmp` and `.app` resources only.

## Label in JavaScript code if your org has a namespace

`$A.get("$Label.namespace.labelName")`

**note:** Updates to a label locale or translation are not immediately in the application. To verify the change immediately, log out and in.

**See Also**  


-   [Value Providers](https://developer.salesforce.com/docs/platform/aura-platform/expr/expr-source.md)
-   [*Salesforce Help*: Translate Custom Labels](https://help.salesforce.com/articleView?id=cl_translate_edit.htm)