Messenger Languages
The chat messenger can appear in each visitor's own language. A visitor whose browser is set to French sees the buttons, tabs, your welcome and your suggested questions in French, and the AI agent answers them in French. You write your settings once, in your own language.
This is separate from translating conversations for your team. Showing the messenger in the visitor's language changes what the visitor sees. Translating conversations changes what your team sees in the inbox and how your replies are sent. Each has its own switch, and you can use either one or both.
Turning it on or off
- Open your messenger and click Settings in its sidebar.
- On the General tab, under Translation, switch Show the messenger in each visitor's language on or off. It's on by default.
- Check the Inbox language. It's the language the messenger falls back to, and the language your settings are written in.
- Click Save settings.
When it's off, every visitor sees the messenger in the inbox language.
How the language is chosen
- If your website passes a
languagewhen it loads the messenger, that language is used. See Choosing the language from your website below. - Otherwise the messenger uses the visitor's browser language. Regional versions count as the language itself, so
fr-CAshows French andpt-BRshows Portuguese. - If that language isn't one of the 42 supported languages, the messenger shows the inbox language.
The language comes from the browser setting, not from where the visitor is. An English speaker browsing from Spain still sees English.
What's translated
| Text | How it's translated |
|---|---|
| The messenger's own words: buttons, tabs, placeholders, the contact form, Talk to a person and so on | Translated in advance and built into Docent, so they show at once. |
| What you wrote in settings: the greeting, introduction, welcome message, suggested questions, featured articles and expected reply time | Translated the first time a visitor in that language opens the messenger, then remembered. If that first translation takes more than a couple of seconds, that visitor sees your original wording. |
| Automatic messages: passing the chat to your team, "we'll get back to you", question rule and procedure messages, their buttons and the rating question | Translated into the conversation's language before they're sent. |
| Proactive messages | Shown in the visitor's language, unless you untick Show it in the visitor's language on the message. See Chat Proactive Messages. |
| The AI agent's answers | Always in the customer's language, whether or not this setting is on. See Configuring the Chat AI Agent. |
| Your help articles in the Help tab | Shown as written. |
Arabic, Hebrew, Persian and Urdu are shown right to left.
Choosing the language from your website
If your site has its own language picker, pass the visitor's choice so the messenger matches the page instead of the browser. Add language to the settings in your install snippet:
When the visitor picks another language on your site without reloading the page, tell the messenger with the JavaScript API:
The language option is ignored when Show the messenger in each visitor's language is off. A language that isn't supported falls back to the inbox language.
Supported languages
| Language | Code | Language | Code |
|---|---|---|---|
| Arabic | ar | Japanese | ja |
| Bulgarian | bg | Korean | ko |
| Catalan | ca | Latvian | lv |
| Chinese | zh | Lithuanian | lt |
| Croatian | hr | Malay | ms |
| Czech | cs | Norwegian | no |
| Danish | da | Persian | fa |
| Dutch | nl | Polish | pl |
| English | en | Portuguese | pt |
| Estonian | et | Romanian | ro |
| Filipino | tl | Russian | ru |
| Finnish | fi | Serbian | sr |
| French | fr | Slovak | sk |
| German | de | Slovenian | sl |
| Greek | el | Spanish | es |
| Hebrew | he | Swahili | sw |
| Hindi | hi | Swedish | sv |
| Hungarian | hu | Thai | th |
| Indonesian | id | Turkish | tr |
| Italian | it | Ukrainian | uk |
| Urdu | ur | ||
| Vietnamese | vi |
These are the same languages you can choose as your inbox language or your own language under Your profile in the inbox. To see the messenger the way a visitor does, open What Visitors See in the Chat Messenger, or set your browser to another language and use Try it on this page in Settings.