Localization

Localization presents the map in multiple languages — both the interface strings and the location content. Enable Localization from the Modules panel, then add languages and provide translations.

Languages

Add languages from the built-in list of over 80 options. Mark one as the default with Set as default (it appears underlined in the list); visitors see the default until they switch.

Property	Description
Code *	Language ISO code, e.g. `en`, `fr`, `de`. Used as the translation key.
Name	Display name shown in the map builder.
Flag	Flag emoji shown in the map builder.

* Required fields

ℹ️

The Name and Flag are only used inside the map builder — they are not shown on the front-end.

Interface translations

The Translations list covers fixed interface text (button labels, prompts, and similar). Each entry has an Original string plus one field per language.

Property	Description
Original *	The exact, case-sensitive interface text to translate.
(per language)	Translation of the original into that language.

* Required fields

⚠️

The original text must match the interface string exactly — including capitalization — for the translation to apply.

Translating location content

With localization enabled, the translatable location fields — Title, About, Link, Description, and the Button label — edit the language currently selected in the builder’s top-bar switcher. With the default language active, the base value is edited; with any other language active, the field (marked with the language’s flag) writes a field_code key such as title_fr, and the matching value is shown when that language is active on the map.

Language selection at runtime

On the live map the language is driven by the host page’s <html lang> attribute — there is no built-in front-end switcher. Mapplic resolves it like this:

The value of <html lang> is used (or, if it is unset, the visitor’s browser language).
An exact match on a language code wins; a region variant falls back to its base code — en-US matches en.
If nothing matches, the map uses the default language.

The attribute is monitored, so the language re-resolves whenever it changes. A site’s own language switcher only needs to update <html lang> and the map follows.

For programmatic control, the active language can also be set with the setLang method — see Language and theme in the JavaScript API.

For the underlying data shapes, see the Language and Translation schemas.