Localize the ad UI

  • Use ImaSdkSettings.setLocale to specify the language of text within UI elements for the HTML5 SDK.

  • The locale must be set before AdDisplayContainer and AdsLoader are initialized and cannot be changed afterwards.

  • A working implementation is available on CodePen.

  • A table of supported locale codes is provided.
Select platform: HTML5 Android iOS tvOS

Specify a locale

The HTML5 SDK uses ImaSdkSettings.setLocale for setting the language of text within UI elements. Locale must be set before AdDisplayContainer and AdsLoader have been initialized and cannot be changed once those objects have been created.

    google.ima.settings.setLocale('fr');
    var adContainerElement = document.getElementById('adContainer');
    var adDisplayContainer = new google.ima.AdDisplayContainer(adContainerElement);
    var adsLoader = new google.ima.AdsLoader(adDisplayContainer);

Try it out

You can see a working implementation in the following:

Locale codes

IMA supports the following locale codes:

Language Country code
Arabic ar
Arabic (Egypt) ar_eg
Arabic (Saudi Arabia) ar_sa
Bulgarian bg
Catalan ca
Chinese (Simplified) zh
Chinese (Simplified, China) zh_cn
Chinese (Traditional, Hong Kong) zh_hk
Chinese (Traditional, Taiwan) zh_tw
Croatian hr
Czech cs
Danish da
Dutch nl
English en
English (Australia) en_au
English (Canada) en_ca
English (United Kingdom) en_gb
English (Ireland) en_ie
English (India) en_in
English (Singapore) en_sg
English (South Africa) en_za
Estonian et
Filipino fil
Finnish fi
French fr
French (Canada) fr_ca
French (Switzerland) fr_ch
German de
German (Austria) de_at
Greek el
Hebrew he
Hindi hi
Hungarian hu
Icelandic is
Indonesian id
Italian it
Japanese ja
Korean ko
Latvian lv
Lithuanian lt
Malay ms
Norwegian no
Polish pl
Portuguese pt
Portuguese (Brazil) pt_br
Portuguese (Portugal) pt_pt
Romanian ro
Russian ru
Serbian sr
Slovak sk
Slovenian sl
Spanish es
Spanish (Latin America) es_419
Spanish (Argentina) es_ar
Spanish (Chile) es_cl
Spanish (Colombia) es_co
Spanish (Costa Rica) es_cr
Spanish (Dominican Republic) es_do
Spanish (Ecuador) es_ec
Spanish (El Salvador) es_sv
Spanish (Guatemala) es_gt
Spanish (Honduras) es_hn
Spanish (Mexico) es_mx
Spanish (Nicaragua) es_ni
Spanish (Panama) es_pa
Spanish (Peru) es_pe
Spanish (Puerto Rico) es_pr
Spanish (Paraguay) es_py
Spanish (United States) es_us
Spanish (Uruguay) es_uy
Spanish (Venezuela) es_ve
Swedish sv
Thai th
Turkish tr
Ukrainian uk
Vietnamese vi