---
updatedAt: 2026-02-25T12:53:53.000Z
---

# 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](https://help.kustomer.com/localization-settings-rJm0Mtpx7) for your organization in the Kustomer Help Center.

|              |          |    |                 |          |    |                      |          |
| :----------- | :------- | :- | :-------------- | :------- | :- | :------------------- | :------- |
| **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

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](https://developer.kustomer.com/chat-sdk/docs/installation#initialize-chat-android-sdk-with-options) to override SDK settings.

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

```kotlin Kotlin code sample to change the default language
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](https://developer.android.com/guide/topics/resources/app-languages) 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.