Skip To ContentArcGIS for DevelopersSign In Dashboard

How does localization work with the ArcGIS for JavaScript API?

The API will automatically use the locale of the browser. If you don't want that behavior, you can set your application to a specific locale.

  // set locale before JSAPI is loaded
  dojoConfig = {
    locale: "ja",
    parseOnLoad: true

You can find more information in Internationalization with the Dojo Toolkit.

Support for right-to-left (RTL)

The ArcGIS API for JavaScript provides bidirectional support. To enable right-to-left (RTL), set the dir attribute in the <html> or <body> tag to rtl.

<html dir="rtl">

This will impact many aspects of the API, for example:

  • Widget content.
  • Themes.
  • Location of default UI components such as zoom in/out widgets.
  • Widget positions specified with leading/trailing options of the UI add/empty/move methods. For left-to-right (LTR), "leading" is left and "trailing" is right. For right-to-left (RTL), "leading" is right and "trailing" is left.

Locale support

The ArcGIS API for JavaScript has support for the following locales.

  • Arabic (ar)
  • Bosnian (bs) - Added in version 4.2
  • Catalan (ca) - Added in version 4.8
  • Simplified Chinese (zh-cn)
  • Traditional Chinese (Hong Kong) (zh-hk)
  • Traditional Chinese (Taiwan) (zh-tw)
  • Croatian (hr) - Added in version 4.1
  • Czech (cs)
  • Danish (da)
  • Dutch (nl)
  • English (en)
  • Estonian (et)
  • Finnish (fi)
  • French (fr)
  • German (de)
  • Greek (el)
  • Hebrew (he)
  • Hungarian (hu) - Added in version 4.8
  • Indonesian (id) - Added in version 4.2
  • Italian (it)
  • Japanese (ja)
  • Korean (ko)
  • Latvian (lv)
  • Lithuanian (lt)
  • Norwegian (nb)
  • Polish (pl)
  • Portuguese (Brazil) (pt-br)
  • Portuguese (Portugal) (pt-pt)
  • Romanian (ro)
  • Russian (ru)
  • Serbian (sr) - Added in version 4.1
  • Slovenian (sl) - Added in version 4.6
  • Spanish (es)
  • Swedish (sv)
  • Thai (th)
  • Turkish (tr)
  • Ukrainian (uk) - Added in version 4.11
  • Vietnamese (vi)