---
schema_version: "1"
id: e3cad7eaf9274c69b367a005792a9e7973d039465cf6317e6992ffa2bf41f613
title: Translate Messaging Components into Your Customer’s Language
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/service/264-0-0/messaging_components_translate.md
canonical_url: https://help.salesforce.com/s/articleView?id=service.messaging_components_translate.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: b8e7ee12ec7c173638b302d264c1136c8a400a0f1349db3de5fbda1965e44c80
description: Show messaging components in a customer’s preferred language with the help of Translation Workbench. For example, when you send a French-speaking customer a question with three options, show the question and options translated into French.
products:
  - Service Cloud
  - Digital Engagement
release: "264"
---
# Translate Messaging Components into Your Customer’s Language

Show messaging components in a customer’s preferred language with the help of Translation Workbench. For example, when you send a French-speaking customer a question with three options, show the question and options translated into French.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <tbody>
          <tr class="">
            <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=service.messaging_editions.htm&amp;type=5&amp;language=en_US" target="_blank">View supported editions.</a></td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">
              <a name="messaging_components_translate__d1003e840"><!-- --></a><span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" id="messaging_components_translate__d1003e840" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/resources-global/_corporate/images/checkmark.png" alt="Checkmark"></span>
              <strong>This article applies to:</strong>
            </td>

            <td class="slds-cell-wrap" style="vertical-align:top;">Enhanced In-App Chat, Enhanced Web Chat v1, Enhanced Web Chat v2, Enhanced
              WhatsApp, Enhanced Facebook Messenger, Enhanced Apple Messages for Business, Enhanced
              LINE, and Bring Your Own Channel</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">
              <span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/resources-global/_corporate/images/crossmark.png" alt="X icon"></span>
              <strong>This article doesn’t apply to:</strong>
            </td>

            <td class="slds-cell-wrap" style="vertical-align:top;">Standard and Enhanced SMS channels</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="d145420e98">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d145420e98 ">To create messaging components:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d145420e98 ">
              <p>Customize Application AND View Setup and Configuration </p>
              <p>OR</p>
              <p style="margin-bottom:0;">System
                Administrator </p>
            </td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d145420e98 ">To send and receive messages in Messaging:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d145420e98 ">Messaging Agent</td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d145420e98 ">To import and export translation files:</td>

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

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

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/images/icon_note.png)

Note Automated messaging doesn’t yet support translated messaging components. If you’re using a flow to automatically send notification messaging components, the original, untranslated version of the component is sent to customers.

#### See Also

- [Enable or Disable Translation Workbench](https://help.salesforce.com/s/articleView?id=platform.customize_wbench.htm&type=5&language=en_US)
- [Add Translated Languages and Translators](https://help.salesforce.com/s/articleView?id=platform.adding_and_editing_translated_languages.htm&type=5&language=en_US)
- [Export Data Translation Files](https://help.salesforce.com/s/articleView?id=platform.workbench_export_data.htm&type=5&language=en_US)
- [Import Translated Files](https://help.salesforce.com/s/articleView?id=platform.workbench_import.htm&type=5&language=en_US)
- [Configure Field-Level Security](https://help.salesforce.com/s/articleView?id=ind.fsc_admin_configure_field_level_security.htm&type=5&language=en_US)

## Step 1: Set Up Translation Workbench

To get started, enable Translation Workbench and select your languages.

1. Enable Translation Workbench in Setup.
2. Add one or more languages. For example, if your default org language is English but you want messaging components to be available in French and Spanish, add French and Spanish.

## Step 2: Prepare Your Messaging Components for Translation

Two parts of a messaging component can be translated:

- The component name, which service reps see in the Service Console.
- All constant values, which are managed from the Constants tab in the Messaging Component Builder. Constants determine the text in the messaging component that customers receive in a message. Several standard constants are automatically added when you first create a component. You can also add custom constants.

If any text in a messaging component is literal, rather than determined by a constant, it can’t be translated and remains in the default org language. To verify that a messaging component uses constants for all text that you want translated, create or open the component in the Messaging Component Builder.

1. In Setup, go to the Messaging Components page.
2. Click the name of the messaging component that you want to be translated.
3. In the left-hand sidebar, click the **Text** format.
4. In the properties pane, review each Formula Template field. If the formula template contains literal text instead of constants, create a custom constant that can replace the literal text. For example, in this question with options component, a constant must replace the phrase “Select an option” in the first formula template so it can be translated.
    
    ![Formula template field highlighted in Builder](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/support_channels/images/messaging/messaging_translate_1.png)
    
    1. In the left-hand sidebar, click **Constants**.
    2. Click **New**.
    3. Give your constant a name, such as SelectionPrompt, and save it.
    4. Click the Text format again.
    5. In the formula template, replace the literal text with your constant. In this example, Select an option becomes {!$Constants.SelectionPrompt}.
    6. Save your changes.
5. If another format was added, click the format name in the left-hand sidebar.
6. In the properties pane, verify that the Type field for all text to be translated is set to Constant and that a constant is selected in the field after it. In this example, the Quick Replies format on a question with static options component is correctly configured.
    
    ![Properties pane of the Quick Replies format with two Type fields showing the Constant value selected](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/support_channels/images/messaging/messaging_translate_2.png)
7. After you configure the properties of all formats added to your component, save your changes.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/images/icon_note.png)

Note Some text in a messaging component doesn’t need to be translated, such as URLs. This text can stay as literal text in a formula template or component property.

## Step 3: Translate Your Component Text

To provide translated versions of a messaging component, manually enter the translation or import a batch of translated text. If you plan to translate multiple messaging components or translate to multiple languages, importing is faster.

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/images/icon_important.png)

Important A messaging component is translated only if Translation Workbench contains translations of all of the component's text constants. For example, if your component includes three constants, provide translations of all three constants. If a translation of any constant is missing, the component isn't translated. This rule helps service reps avoid sending a message that uses multiple languages.

Provide translations manually:

1. In Setup, go to the Translate page under Translation Workbench.
2. In the Language field, select the language to which you want to translate your messaging component; for example, French.
3. In the Setup Component field, select **Messaging Component**.
4. In the Messaging Component field, select the developer name of the component to be translated.
5. In the Object field, select **Messaging Component Name**. The component name appears in a table.
6. Hover over the table and click the pencil icon, then enter the translation of the messaging component name. For example, service reps whose language is set to French see the French name of the component in the Service Console.
7. In the Object field, select Constant Values. All of the component’s constants appear in a table.
8. Hover over the table and click the pencil icon, then enter the translation of each constant.
9. Save your changes.

To provide translations in a batch, export a data translation file from the Export page in Setup under Translation Workbench. When exporting, select the Messaging Component Name or Constant Values object. After completing one file per language, import them on the Import page.

## Step 4: Send Translated Messaging Components

After you provide translated versions of your messaging components, your support team can send them to customers.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/images/icon_note.png)

Note For enhanced chat, enhanced Apple Messages for Business and Bring Your Own Channels, you can now enable the **Identify preferred language of messaging users** option in Setup, so Salesforce auto-populates the Language field.

1. (Admin task) Enable access to the Messaging User Language field for service rep profiles, and then add it to the Messaging Session page layout. Service reps need edit access to this field to send translated messaging components.
2. At the start of a messaging session, update the Messaging User Language field on the messaging session record to list the customer’s preferred language. You can gather this information contextually or via a bot question that auto-completes the field.
    
    If you enabled the **Identify preferred language of messaging users** option in Setup, you can skip this step.
3. Click the messaging component action and click **Insert** on a component to send.
4. Click **Send**. If Translation Workbench contains a version of the component in the customer’s preferred language, the customer sees the messaging component in their language.

![Example](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/images/icon_example.png)

Example Your default org language is English, and you created a range of messaging components in English. To support your French-speaking customers, you upload French translations of the components in Translation Workbench.

When a customer initiates a messaging session with a French message, the service rep updates the Messaging User Language on the session record to French. Any components that the rep sends during the session appear to the customer in French. 

If a component is available in a service rep's default language, the rep sees the component name in their language in the list of messaging components shown in the Service Console. Otherwise, it shows the original component name.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/images/icon_note.png)

Note While auto-response messaging components can be translated like any other component, the messaging session record must list a Messaging User Language so Salesforce knows what language to use. Auto-response messaging components aren't translated for Enhanced WhatsApp, Enhanced Facebook Messenger, Enhanced SMS, and Enhanced LINE channels.

## Step 5: Keep Translations Up to Date

If a messaging component is updated in the Messaging Component Builder, it’s important to update translations of the component to reflect the changes. Regularly check for outdated translations and update them as needed.

On the Translate page in Setup, **Out of date** is selected on any translations whose original language underwent an update after the translated version was saved. You can manually update individual translations on the Translate page. Or, go to the Export page and export a list of messaging component translations marked **Out of date**.