Localization

Learn how to localize Kustomer Chat.

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 language locales out of the box:

LanguageCodeLanguageCodeLanguageCode
AfrikaansafGermandeRussianru
AlbaniansqGreekelSerbiansr
ArabicarHebrewheSerbian (Montenegro)sr_me
Arabic (EG)ar_egHindihiSimplified Chinesezh_cn
Arabic (MA)ar_maHungarianhuSinhalasi
BelarusianbeIcelandicisSlovakiansk
BosnianbsIndonesianidSloveniansl
BulgarianbgItalianitSpanishes
CatalancaJapanesejaSpanish (AR)es_ar
Croatianhr.Kannadakn.Spanish (PA)es_pa
CzechcsKazakhkkSpanish (PE)es_pe
DanishdaKoreankoSpanish (Spain)es_es
DutchnlKyrgyzkySwahilisw
English (CA)en_caLatvianlvSwedishsv
English (UK)en_gbLithuanianltTamilta
English (US)en_usLuxembourgishlbTelugute
EstonianetMongolianmnThaith
FilipinofilNorwegiannoTraditional Chinesezh_tw
FinnishfiPersianfaTurkishtr
FrenchfrPolishplTwitw
French (CA)fr_caPortuguese (BR)brUkrainianuk
French (MA)fr_maPortuguese (PT)ptUrduur
GeorgiankaPunjabipaVietnamesevi
Romanianro

Change the default language

Kustomer uses the device language as the default language. To change the default language, pass in the desired language locale when you initialize chat with options to override SDK settings.

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

val options = KustomerOptions.Builder()
              .setUserLocale(Locale("en-US")) // use hyphen to append country code

Kustomer.init(application = this, apiKey = apiKey, options = options.build()) {
    Log.i(TAG,"Kustomer is initialized ${it.dataOrNull}")
}

Per application language settings

If your app supports per app language settings available on Android 13, the same localization settings can be honored in the Kustomer Android Chat SDK starting from v3.1.0 and higher. To enable this feature, simply use KustomerOptions.useAppLocales during Kustomer initialization process. When this flag is enabled, the Kustomer UI will use the same application locales set by AppCompatDelegate.getApplicationLocales().

By default, the SDK will use the system locales if no localization preferences are set. It is advised that this option shouldn't used in conjunction with KustomerOptions.userLocale and doing so will ignore the custom user locale set in KustomerOptions.userLocale and will use app languages instead.