---
title: Set localization options with XCUITest
description: 'XCUITest: change localization settings on iOS devices. Set a locale,
  language and timezone with XCUITest.'
source_url:
  html: https://testingbot.com/support/app-automate/xcuitest/set-localization-options
  md: https://testingbot.com/support/app-automate/xcuitest/set-localization-options/index.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#)

    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.

    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#)

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

    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#)

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

    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)[Slack Join our Slack](https://join.slack.com/t/testingb0t/shared_invite/zt-3bcw9xch-jk19~6XPs_xBrsAgAedkCw)