Learn how to localize Kustomer Chat.

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

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

Supported languages

The Kustomer Chat SDK supports the following language locales out of the box:

ArabicarHebrewheSerbian (Montenegro)sr_me
Arabic (EG)ar_egHindihiSimplified Chinesezh_cn
Arabic (MA)ar_maHungarianhuSinhalasi
CatalancaJapanesejaSpanish (AR)es_ar
CroatianhrKazakhkkSpanish (PA)es_pa
CzechcsKoreankoSpanish (PE)es_pe
DanishdaKyrgyzkySpanish (Spain)es_es
English (CA)en_caLithuanianltSwedishsv
English (UK)en_gbLuxembourgishlbTamilta
English (US)en_usMongolianmnThaith
EstonianetNorwegiannoTraditional Chinesezh_tw
FrenchfrPortuguese (BR)brUkrainianuk
French (CA)fr_caPortuguese (PT)ptUrduur
French (MA)fr_maPunjabipaVietnamesevi

Change the default language

Kustomer uses the device language as the default language. To change the default language, set options.language to the desired language locale during Configuration.

In the example below, we use options.language to set the default language to French:

options.language = .fr


en_us as the backup language for Knowledge Base articles

If you don't have a knowledge base available in the default language, Kustomer loads Knowledge Base articles for the en_us (English, US) locale as a backup.

Customize the built-in .lproj localizations

You can create overrides for strings for existing localizations if you'd like to customize or change the translations for specific values.

To customize built-in localizations, your project must have a Kustomer.strings file.

Create the Kustomer.strings file

If your project does not yet have a Localizable.strings file with the different language localizations, you can create the file in Xcode.

To create the Kustomer.strings file for your project:

  1. Open your project in Xcode, and go to File > New > File and select Resource under the iOS category in the sidebar.

  2. From the files, select Strings File and select Next.

  3. Name the file Kustomer and select Create.

You will now have a Kustomer.strings file in your project.

Customize the Chat SDK strings with new values:

Once you have a Kustomer.strings file in your project, you can customize strings in the file.

To customize the Chat SDK strings in the Kustomer.strings file with new values:

  1. Choose and add the strings to customize to the Kustomer.strings file in the following format:
// Add a key and change the value to what you want
"com.kustomer.week" = "Your Custom String Value";
  1. In Xcode, go to the Build Phases tab and make sure that the updated file is located in Copy Bundle Resources.

Add a new localization

You can add new localization strings for a language if the language is not included in the Chat SDK.

To add a new localization to your project:

  1. In Xcode, select your Kustomer.strings file. On the right panel, go to Localize and select the language you would like to add. When you select the language, Xcode creates a different Kustomer.strings file for the language.

  2. In the new file, add translations for all of the strings available in the SDK.