Localization

The Kustomer Chat SDK supports over 50 languages out of the box. It automatically translates strings into the primary language of the customer's language locale.

You can learn more about how to customize localization settings for your organization in the Kustomer Help Center.

Supported languages

The Kustomer Chat SDK supports the following languages out of the box:


Language	Code		Language	Code		Language	Code
Afrikaans	`af`		German	`de`		Russian	`ru`
Albanian	`sq`		Greek	`el`		Serbian	`sr`
Amharic	`am`		Hebrew	`he`		Serbian (Montenegro)	`sr_me`
Arabic	`ar`		Hindi	`hi`		Simplified Chinese	`zh_cn`
Arabic (EG)	`ar_eg`		Hungarian	`hu`		Sinhala	`si`
Arabic (MA)	`ar_ma`		Icelandic	`is`		Slovakian	`sk`
Belarusian	`be`		Indonesian	`id`		Slovenian	`sl`
Bosnian	`bs`		Italian	`it`		Spanish	`es`
Bulgarian	`bg`		Japanese	`ja`		Spanish (AR)	`es_ar`
Catalan	`ca`	.	Kannada	`kn`	.	Spanish (PA)	`es_pa`
Croatian	`hr`		Kazakh	`kk`		Spanish (PE)	`es_pe`
Czech	`cs`		Korean	`ko`		Spanish (Spain)	`es_es`
Danish	`da`		Kyrgyz	`ky`		Swahili	`sw`
Dutch	`nl`		Latvian	`lv`		Swedish	`sv`
English (CA)	`en_ca`		Lithuanian	`lt`		Tamil	`ta`
English (UK)	`en_gb`		Luxembourgish	`lb`		Telugu	`te`
English (US)	`en_us`		Malay	`ms`		Thai	`th`
Estonian	`et`		Mongolian	`mn`		Traditional Chinese	`zh_tw`
Filipino	`fil`		Norwegian	`no`		Turkish	`tr`
Finnish	`fi`		Persian	`fa`		Twi	`tw`
French	`fr`		Polish	`pl`		Ukrainian	`uk`
French (CA)	`fr_ca`		Portuguese (BR)	`br`		Urdu	`ur`
French (MA)	`fr_ma`		Portuguese (PT)	`pt`		Vietnamese	`vi`
Georgian	`ka`		Romanian	`ro`

Change the default language

The Kustomer Chat SDK uses the device's language locale to determine which language to use. You can override the language locale by setting the language property on the KustomerOptions object when configuring the SDK.

Runtime language changes are not supported at this time.

In the example below, we set the default language to English, US:

import KustomerChat, { KustomerLanguage } from '@kustomer/chat-react-native';

KustomerChat.configure({
  language: KustomerLanguage.en_us, // or "en_us" if using JavaScript
});