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.
The Kustomer Chat SDK supports the following language locales out of the box:
|Arabic (EG)||Hindi||Simplified Chinese|
|French (CA)||Portuguese (PT)||Urdu|
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_usas 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.
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
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:
Open your project in Xcode, and go to File > New > File and select Resource under the iOS category in the sidebar.
From the files, select Strings File and select Next.
Name the file
Kustomerand select Create.
You will now have a
Kustomer.strings file in your project.
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:
- Choose and add the strings to customize to the
Kustomer.stringsfile in the following format:
// Add a key and change the value to what you want "com.kustomer.week" = "Your Custom String Value";
- In Xcode, go to the Build Phases tab and make sure that the updated file is located in Copy Bundle Resources.
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:
In Xcode, select your
Kustomer.stringsfile. 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.stringsfile for the language.
In the new file, add translations for all of the strings available in the SDK.
Updated about 2 years ago