Device Locale

Set device language and region for localization testing.

INFO

The default locale for Android is en_US . The default locale for iOS is currently en_GB but will be changing to en_US later in 2026.

Format

{language_code}_{COUNTRY_CODE}

Language: ISO-639 (two or three lowercase letters)
Country: ISO-3166-1 (two uppercase letters)

The underscore is required: use de_DE, not de-DE.

WARNING

The locale isn't checked when you submit a run, only when the device is prepared. If it doesn't match this format:

Android: the error is logged and the test runs in the default locale.
iOS: the device can't be prepared, so the test is retried and eventually fails.

Usage

To set locale for the whole upload:

bash

# German
dcd cloud ... --device-locale de_DE

# With device selection
dcd cloud ... --android-device pixel-6 --device-locale ja_JP

To override locale for a specific test, pass in the DeviceCloud env variable. This will override the upload setting above, but just for a single test:

yaml

# in your test.yaml
appId: my.app
env:
    DEVICECLOUD_OVERRIDE_DEVICE_LOCALE: de_DE
---
# test steps

Common Locales

European

en_GB: English (UK)
de_DE: German
fr_FR: French
it_IT: Italian

Asian

zh_CN: Chinese
ja_JP: Japanese
ko_KR: Korean

RTL

ar_SA: Arabic
he_IL: Hebrew

Device Locale ​

Format ​

Usage ​

Common Locales ​

European ​

Asian ​

RTL ​