Test in different locales

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:

{% code title="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 codeLanguage 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 codeCountry 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 codeLocale 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

Last updated