Ask about anything in Docent Documentation

Type a question in your own words below. Answers are written from our published articles and cite the ones they came from.

Recently updated

    ↑↓ select · ↵ open · esc close
    Dashboard
    Edit Article Logout

    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.


    How helpful was this article?

    👍 or 👎

    Related Articles

    Markdown Version