---
title: Set localization options with XCUITest
description: 'XCUITest: change localization settings on iOS devices. Set a locale,
  language and timezone with XCUITest. Covers Setting Language for iOS XCUI Tests.'
source_url:
  html: https://testingbot.com/support/app-automate/xcuitest/set-localization-options
  md: https://testingbot.com/support/app-automate/xcuitest/set-localization-options.md
---

# Set localization options

TestingBot provides an option to run XCUITests on a localized version of your iOS mobile application.   
 Configure the language, locale and timezone of the remote iOS device before running your XCUITest suite.

## Setting Language for iOS XCUI Tests

Test a localized version of your mobile app with iOS XCUITest, by changing the language of the application under test.   
 You will need to specify a `language` option with the ISO code of the language you want to use.

[CLI](https://testingbot.com#) [cURL](https://testingbot.com#)

```bash
testingbot xcuitest app.ipa app-test.zip \
  --device "iPhone 13" \
  --real-device \
  --language "fr"
```

Use an [ISO 639-1 language code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) to set the language of your app.   
 Your app needs to be compiled with support for this language to notice a change.

```bash
curl -u api_key:api_secret \
-X POST "https://api.testingbot.com/v1/app-automate/xcuitest/:id/run" \
-d '{ "options": { "language": "fr" }, "capabilities":[{"version":"15.5", "deviceName":"iPhone 13", "platformName":"iOS"}]}' \
-H "Content-Type: application/json"
```

Use an [ISO 639-1 language code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) to set the language of your app.   
 Your app needs to be compiled with support for this language to notice a change.

## Set a locale for XCUI Testing

You can change the locale before running your XCUITest with the `locale` parameter.

Please use the CA format (country name abbreviation). For example: `DE` for Germany.

[CLI](https://testingbot.com#) [cURL](https://testingbot.com#)

```bash
testingbot xcuitest app.ipa app-test.zip \
  --device "iPhone 13" \
  --real-device \
  --locale "DE"
```

```bash
curl -u api_key:api_secret \
-X POST "https://api.testingbot.com/v1/app-automate/xcuitest/:id/run" \
-d '{ "options": { "locale": "DE" }, "capabilities":[{"version":"15.5", "deviceName":"iPhone 13", "platformName":"iOS"}]}' \
-H "Content-Type: application/json"
```

## Change timezone for XCUITests

If you'd like to change the timezone before starting your XCUITests, you can use the `timeZone` option.

Please use a timezone format from the [list of timezones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).

[CLI](https://testingbot.com#) [cURL](https://testingbot.com#)

```bash
testingbot xcuitest app.ipa app-test.zip \
  --device "iPhone 13" \
  --real-device \
  --timezone "America/New_York"
```

```bash
curl -u api_key:api_secret \
-X POST "https://api.testingbot.com/v1/app-automate/xcuitest/:id/run" \
-d '{ "options": { "timeZone": "America/New_York" }, "capabilities":[{"version":"15.5", "deviceName":"iPhone 13", "platformName":"iOS"}]}' \
-H "Content-Type: application/json"
```

### Looking for more help?

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

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