orka.Developers
Developers / Web SDK

Language

The widget speaks the language of the visitor's browser when it is one of English, French, German, Spanish, Italian and Portuguese, and falls back to English. The texts you wrote yourself (welcome message, banners) are shown as you wrote them.

The browser language of each visitor is shown to your team, and conversations can be translated both ways from the inbox.

Force a language

Your product has its own language switch? Make the widget follow it. Set ORKA_LOCALE before the snippet, with a two-letter ISO 639-1 code:

<script type="text/javascript">
  window.ORKA_LOCALE = "fr";
</script>

A longer code such as fr-CA is accepted, its first two letters are used. An unsupported language is ignored: the widget uses the language of the browser, English when that one is not supported either. The language is read when the widget loads: after a language switch in a single page application, reload the page, or call Orka.destroy() then Orka.load().

This changes the texts of the widget only. The browser language of the visitor is still what your team sees, and what conversation translation uses.