You are here:
Translate Your Chat Window
The primary language for a chat window is set in your embedded code snippet. An extra step in Translation Workbench is required for custom labels or platform-only languages.
Required Editions
| View supported editions. |
Legacy Chat will be retired on February 14, 2026. To avoid service interruptions to your end users, switch to enhanced Chat (formerly Messaging for In-App and Web). Enhanced Chat offers many of the legacy Chat features that you love plus asynchronous conversations that can be picked back up at any time. Learn about migrating in Help and Trailhead.
Set your primary language in your Embedded Service code snippet. All of your chat window labels have a default translation set for any Salesforce fully supported or end-user language that you’ve added.
Follow these additional steps if you would like to create custom labels or if you want to include a platform-only language:
- To translate labels for your chat window, view your Embedded Service deployment in Setup.
- Open your Chat, Field Service or Flows settings, and click Edit next to Additional branding.
- Click the Labels tab to view and customize the labels in your chat window.
- Select the arrow next to a label and click View Label Record, where you can select to translate the label in the Translation Workbench.
Important considerations for translations:
- If no language is set in your code snippet or if it’s invalid (due to an empty string, wrong format, or language not supported), the language of the Site Guest User for the Site of your Embedded Service deployment is used.
- When Translation Workbench is disabled, the language of the Site Guest User for the Site of your Embedded Service deployment is used.
- To ensure that translated labels are packaged in an Embedded Service deployment, in Package Manager setup add Language Translations as the Component Type. Select the languages you wish to package with the deployment and click Add to package.
- Not all languages are automatically available for Salesforce components. To use these end-user and platform-only languages, enable them in Languages Settings under Company Settings.
