Test in different locales

Create devices with specific locales using maestro start-device --device-locale for localized testing.

It is possible to use maestro start-device command to create a new device with a custom locale. This functionality enables an option to write and test Maestro flows for different languages. The parameter --device-locale is a combination of ISO-639-1 + ISO-3166-1, separated by an underscore _ symbol in between them.

Let's see some examples:

Create a new iOS simulator with locale set to Italy (Italian)

maestro start-device \
  --platform ios \
  --device-locale it_IT

Create a new Android emulator with locale set to France (French)

maestro start-device \
  --platform android \
  --device-locale fr_FR

Below you can find a full list of supported device locales per platform.

Supported device locales on Android

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

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

Supported device locales on iOS

Locale code	Locale name
en_AU	Australia (English)
nl_BE	Belgium (Dutch)
fr_BE	Belgium (French)
ms_BN	Brunei Darussalam
en_CA	Canada (English)
fr_CA	Canada (French)
cs_CZ	Czech Republic
fi_FI	Finland
de_DE	Germany
el_GR	Greece
hu_HU	Hungary
hi_IN	India (Hindi)
id_ID	Indonesia
he_IL	Israel
it_IT	Italy
ja_JP	Japan
ms_MY	Malaysia
nl_NL	Netherlands
en_NZ	New Zealand
nb_NO	Norway
tl_PH	Philippines
pl_PL	Poland
zh_CN	PRC
ro_RO	Romania
ru_RU	Russia
en_SG	Singapore
sk_SK	Slovakia
ko_KR	Korea
sv_SE	Sweden
zh_TW	Taiwan
th_TH	Thailand
tr_TR	Turkey
en_GB	UK (English)
uk_UA	Ukraine
es_US	USA (Spanish)
en_US	USA (English)
vi_VN	Vietnam
pt-BR	Brazil (Portuguese)
zh-Hans	China (Simplified)
zh-Hant	China (Traditional)
zh-HK	Hong Kong
en-IN	India (English)
en-IE	Ireland
es-419	Latin America (Spanish)
es-MX	Mexico (Spanish)
en-ZA	South Africa (English)
es_ES	Spain
fr_FR	France