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

  1. Open your messenger and click Settings in its sidebar.
  2. On the General tab, under Translation, switch Show the messenger in each visitor's language on or off. It's on by default.
  3. Check the Inbox language. It's the language the messenger falls back to, and the language your settings are written in.
  4. Click Save settings.

When it's off, every visitor sees the messenger in the inbox language.

How the language is chosen

  1. If your website passes a language when it loads the messenger, that language is used. See Choosing the language from your website below.
  2. Otherwise the messenger uses the visitor's browser language. Regional versions count as the language itself, so fr-CA shows French and pt-BR shows Portuguese.
  3. 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

TextHow it's translated
The messenger's own words: buttons, tabs, placeholders, the contact form, Talk to a person and so onTranslated 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 timeTranslated 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 questionTranslated into the conversation's language before they're sent.
Proactive messagesShown 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 answersAlways in the customer's language, whether or not this setting is on. See Configuring the Chat AI Agent.
Your help articles in the Help tabShown 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:

window.DocentSettings = { app_id: "YOUR_APP_ID", language: "es" // or "fr-CA", "de", "ja"... };

When the visitor picks another language on your site without reloading the page, tell the messenger with the JavaScript API:

Docent('update', { language: 'fr' });

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

LanguageCodeLanguageCode
ArabicarJapaneseja
BulgarianbgKoreanko
CatalancaLatvianlv
ChinesezhLithuanianlt
CroatianhrMalayms
CzechcsNorwegianno
DanishdaPersianfa
DutchnlPolishpl
EnglishenPortuguesept
EstonianetRomanianro
FilipinotlRussianru
FinnishfiSerbiansr
FrenchfrSlovaksk
GermandeSloveniansl
GreekelSpanishes
HebrewheSwahilisw
HindihiSwedishsv
HungarianhuThaith
IndonesianidTurkishtr
ItalianitUkrainianuk
Urduur
Vietnamesevi

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.