Languages MapTiler logo

The MapTiler SDK JS has a built-in list of compatible languages, which can be used as shorthand for the ISO language codes used to define the language of the map labels. The language generally depends on the map's style.

The MapTiler SDK JS also provides seamless support for right-to-left languages. Arabic, Hebrew, and other right-to-left languages are fully supported by default. No extra plugins are needed.

Check out the complete list of supported languages. In addition to the built-in languages, there are these special cases for supported languages:

  • Language.AUTO: uses the default language of the browser
  • Language.INTERNATIONAL: uses the international name. This option is equivalent to OSM's name int_name
  • Language.LATIN: uses the default fallback language in the Latin charset
  • Language.LOCAL: uses the local language for each country
  • Language.NON_LATIN: uses the default fallback language in the non-Latin charset
  • Language.STYLE: uses the language defined by the style
    Language.STYLE is the default state. Once you switch the language from STYLE, you cannot switch it back.
  • Language.STYLE_LOCK: keep the language from the style and prevent any further updates
  • Language.VISITOR: uses the preferred language from the user settings and the "default name". This mode is useful when a user needs to access both local names and English names, for example, when traveling abroad where signs are likely to be available only in the local language
  • Language.VISITOR_ENGLISH: uses English and the "default name". This mode is useful when a user needs to access both local names and English names, for example, when traveling abroad where signs are likely to be available only in the local language
The "default name" is equivalent to OSM's {name}, which is either the most globally recognized name or the local name.
Reference documentation of MapTiler SDK JS, an extension of MapLibre GL JS