Hello 👋 How can we help?

Widget localization

Localization lets you serve customers from across the globe in their native languages.
Written by Anastasiia
Updated 1 week ago

HelpCrunch chat widget has been already localized into several languages (GE, FR, ES, PT, RU, PL) — both for online and offline modes. You can also add your own phrases and localizations.

There are two ways to add new localization:

  • Manually via your HelpCrunch account.
  • Through API, so that your website could automatically detect your visitor’s language and apply the corresponding localization.

Adding localizations manually

STEP 1. To localize the text into a new language, log into your HelpCrunch account and go to Settings → Website Widgets → Your Website → 'Localization' tab and click the 'Add localization' button.

STEP 2. Name the new Phrase List by indicating the language you need — for example, Dutch (NL). If you want to show this localization by default, check the corresponding checkbox.

STEP 3. Fill in all the fields with new phrases in the corresponding language and hit 'Apply' to save changes.

Go to your website and reload the page to switch the chat into the chosen language.

Integrating localizations through your website

STEP 1. First of all, you need to name your phrase list with a two-letter standard code (let’s say 'en' for English). Check the full list of ISO 639-1 codes if you need help with names.

STEP 2. Add the following command to the chat widget JS code on your website:

HelpCrunch('setPhraseList', 'en');

Now the chat widget phrases will be automatically displayed in English — or any language you set.

Adding automatic localization based on the visitor's language

You can automatically detect a visitor’s browser language and display your chat widget in the corresponsing language:

STEP 1. All the phrase lists should be named with the help of the two-letter standard language codes (full list of ISO 639-1 codes).

STEP 2. Add the following command to the chat widget JS code on your website:

HelpCrunch('setPhraseList', navigator.language.slice(0,2));

Now, tou don’t have to switch localizations manually. The chat widget phrases will be automatically selected from available localizations and displayed in the visitor’s language.

Right-to-left text language support

You can localize your HelpCrunch chat into a right-to-left (RTL) language.

You can also do that on a per-page basis, for example if you have both English and Hebrew on your site, you can paste the following code onto RTL pages beneath your existing HelpCrunch code:

HelpCrunch('setRtlDirection')

Did this answer your question?