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:
Column Title | Column Title | Column Title | Column Title | Column Title | Column Title | Column Title | Column Title |
**Language** | **Code** | | **Language** | **Code** | | **Language** | **Code** |
Afrikaans | `af ` | | German | `de ` | | Russian | `ru ` |
Albanian | `sq ` | | Greek | `el ` | | Serbian | `sr ` |
Arabic | `ar ` | | Hebrew | `he ` | | Serbian (Montenegro) | `sr_me ` |
Arabic (EG) | `ar_eg ` | | Hindi | `hi ` | | Simplified Chinese | `zh_cn ` |
Arabic (MA) | `ar_ma ` | | Hungarian | `hu ` | | Sinhala | `si ` |
Belarusian | `be ` | | Icelandic | `is ` | | Slovakian | `sk ` |
Bosnian | `bs ` | | Indonesian | `id ` | | Slovenian | `sl ` |
Bulgarian | `bg ` | | Italian | `it ` | | Spanish | `es ` |
Catalan | `ca ` | | Japanese | `ja ` | | Spanish (AR) | `es_ar ` |
Croatian | `hr ` | | Kazakh | `kk ` | | Spanish (PA) | `es_pa ` |
Czech | `cs ` | | Korean | `ko ` | | Spanish (PE) | `es_pe ` |
Danish | `da ` | | Kyrgyz | `ky ` | | Spanish (Spain) | `es_es ` |
Dutch | `nl ` | | Latvian | `lv ` | | Swahili | `sw ` |
English (CA) | `en_ca ` | | Lithuanian | `lt ` | | Swedish | `sv ` |
English (UK) | `en_gb ` | | Luxembourgish | `lb ` | | Tamil | `ta ` |
English (US) | `en_us ` | | Mongolian | `mn ` | | Thai | `th ` |
Estonian | `et ` | | Norwegian | `no ` | | Traditional Chinese | `zh_tw ` |
Filipino | `fil ` | | Persian | `fa ` | | Turkish | `tr ` |
Finnish | `fi ` | | Polish | `pl ` | | Twi | `tw ` |
French | `fr ` | | Portuguese (BR) | `br ` | | Ukrainian | `uk ` |
French (CA) | `fr_ca ` | | Portuguese (PT) | `pt ` | | Urdu | `ur ` |
French (MA) | `fr_ma ` | | Punjabi | `pa ` | | Vietnamese | `vi ` |
Georgian | `ka ` | | Romanian | `ro ` | | | |
## 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:
`
en_us
` as the backup language for Knowledge Base articlesIf 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:
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 `
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:
Choose and add the strings to customize to the `
Kustomer.strings
` file in the following format:
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:
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.In the new file, add translations for all of the strings available in the SDK.