---
title: Change the localization settings of iOS and Android
description: Appium Testing with localization options. Change the timezone, locale
  and date for your Automated Tests.
source_url:
  html: https://testingbot.com/support/app-automate/appium/localization-options
  md: https://testingbot.com/support/app-automate/appium/localization-options/index.md
---
# Localization testing on iOS and Android

When running tests with Appium, you can choose to set a specific locale for the device or emulator, by using the `appium:locale` capability.

Specifying this capability will make sure the device/emulator and app will display or format data such as dates, time, decimal separators and calendars according to the specified country's regional conventions.

**The expected value format depends on the platform:**

- **Android:** two-letter region code, e.g. `ES` for Spain (see the Android table below). The example below uses `"ES"`.
- **iOS:** language\_region locale identifier, e.g. `es_ES`, `fr_CA` (see the iOS table below). On iOS, the example below would be `"es_ES"` instead of `"ES"`.

You can also change the Simulator UI locale at runtime using the script command `mobile: configureLocalization`.

[Ruby](https://testingbot.com#)[Python](https://testingbot.com#)[PHP](https://testingbot.com#)[Java](https://testingbot.com#)[NodeJS](https://testingbot.com#)[C#](https://testingbot.com#)

    capabilities = {
        "appium:locale" => "ES"
    }

    options.setCapability("appium:locale", "ES");

    $capabilities = [
        "appium:locale" => "ES"
    ];

    capabilities = {
        "appium:locale": "ES"
    }

    const capabilities = {
        "appium:locale": "ES"
    };

    options.AddAdditionalAppiumOption("appium:locale", "ES");

## Android locale codes

| Locale | Locale Code |
| --- | --- |
| Australia | AU |
| Austria | AT |
| Belgium | BE |
| Brazil | BR |
| Britain | GB |
| Bulgaria | BG |
| Canada | CA |
| Croatia | HR |
| Czech Republic | CZ |
| Denmark | DK |
| Egypt | EG |
| Finland | FI |
| France | FR |
| Germany | DE |
| Greece | GR |
| Hong-Kong | HK |
| Hungary | HU |
| India | IN |
| Indonesia | ID |
| Ireland | IE |
| Israel | IL |
| Italy | IT |
| Japan | JP |
| Korea | KR |
| Latvia | LV |
| Liechtenstein | LI |
| Lithuania | LT |
| Mexico | MX |
| Netherlands | NL |
| New Zealand | NZ |
| Norway | NO |
| Philippines | PH |
| Poland | PL |
| Portugal | PT |
| PRC | CN |
| Romania | RO |
| Russia | RU |
| Serbia | RS |
| Singapore | SG |
| Slovakia | SK |
| Slovenia | SI |
| Spain | ES |
| Sweden | SE |
| Switzerland | CH |
| Taiwan | TW |
| Thailand | TH |
| Turkey | TR |
| Ukraine | UA |
| US | US |
| USA | US |
| Vietnam | VN |
| Zimbabwe | ZW |

## iOS locale codes

| Locale | Locale Code |
| --- | --- |
| Australia  | en\_AU |
| Belgium  | nl\_BE |
| Belgium  | fr\_BE |
| Brunei Darussalam | ms\_BN |
| Canada  | en\_CA |
| Canada | fr\_CA |
| Czech Republic  | cs\_CZ |
| Finland | fi\_FI |
| Germany  | de\_DE |
| Greece | el\_GR |
| Hungary | hu\_HU |
| India | hi\_IN |
| Indonesia | id\_ID |
| Israel | he\_IL |
| Italy | it\_IT |
| Japan | ja\_JP |
| Malaysia | ms\_MY |
| Netherlands  | nl\_NL |
| New Zealand   | en\_NZ |
| Norway | nb\_NO |
| Philippines  | tl\_PH |
| Poland | pl\_PL |
| PRC  | zh\_CN |
| Romania | ro\_RO |
| Russia | ru\_RU |
| Singapore | en\_SG |
| Slovakia | sk\_SK |
| Korea | ko\_KR |
| Sweden  | sv\_SE |
| Taiwan  | zh\_TW |
| Thailand  | th\_TH |
| Turkey  | tr\_TR |
| UK  | en\_GB |
| Ukraine  | uk\_UA |
| US | es\_US |
| USA | en\_US |
| Vietnam  | vi\_VN |
| Brazil | pt-BR |
| China (Simplified) | zh-Hans |
| China (Traditional) | zh-Hant |
| Hong Kong | zh-HK |
| India | en-IN |
| Ireland | en-IE |
| Latin America | es-419 |
| Mexico | es-MX |
| South Africa | en-ZA |

## Change Language

Specify the `appium:language` capability to set the language of the app under test, and the device/emulator.

On iOS, you can set the language to for example French: `fr`. More information is available in the [Language IDs documentation](https://developer.apple.com/library/archive/documentation/MacOSX/Conceptual/BPInternational/LanguageandLocaleIDs/LanguageandLocaleIDs.html).

You can also change the Simulator UI language at runtime using the following script command: `mobile: configureLocalization`.

[Ruby](https://testingbot.com#)[Python](https://testingbot.com#)[PHP](https://testingbot.com#)[Java](https://testingbot.com#)[NodeJS](https://testingbot.com#)[C#](https://testingbot.com#)

    capabilities = {
        "appium:language" => "es"
    }

    options.setCapability("appium:language", "es");

    $capabilities = [
        "appium:language" => "es"
    ];

    capabilities = {
        "appium:language": "es"
    }

    const capabilities = {
        "appium:language": "es"
    };

    options.AddAdditionalAppiumOption("appium:language", "es");

### Android language codes

| Language | Language Code |
| --- | --- |
| Arabic | ar |
| Bulgarian | bg |
| Catalan | ca |
| Chinese | zh |
| Croatian | hr |
| Czech | cs |
| Danish | da |
| Dutch | nl |
| English | en |
| Finnish | fi |
| French | fr |
| German | de |
| Greek | el |
| Hebrew | he |
| Hindi | hi |
| Hungarian | hu |
| Indonesian | id |
| Italian | it |
| Japanese | ja |
| Korean | ko |
| Latvian | lv |
| Lithuanian | lt |
| Norwegian-Bokmol | nb |
| Polish | pl |
| Portuguese | pt |
| Romanian | ro |
| Russian | ru |
| Serbian | sr |
| Slovak | sk |
| Slovenian | sl |
| Spanish | es |
| Swedish | sv |
| Tagalog | tl |
| Thai | th |
| Turkish | tr |
| Ukrainian | uk |
| Vietnamese | vi |

### iOS language codes

| Language | Language Code |
| --- | --- |
| Chinese | zh |
| Czech | cs |
| Dutch | nl |
| English | en |
| Finnish | fi |
| French | fr |
| German | de |
| Greek | el |
| Hebrew | he |
| Hindi | hi |
| Hungarian | hu |
| Indonesian | id |
| Italian | it |
| Japanese | ja |
| Korean | ko |
| Malay | ms |
| Norwegian (Bokmal) | nb |
| Polish | pl |
| Portuguese (Brazil) | pt |
| Romanian | ro |
| Russian | ru |
| Slovak | sk |
| Spanish | es |
| Swedish | sv |
| Tagalog | tl |
| Thai | th |
| Turkish | tr |
| Ukrainian | uk |
| Vietnamese | vi |

### Looking for more help?

Have questions or need more information? Reach out via email or Slack.

[Email us](https://testingbot.com/contact/new)[Slack Join our Slack](https://join.slack.com/t/testingb0t/shared_invite/zt-3bcw9xch-jk19~6XPs_xBrsAgAedkCw)