Multi-language map (8 minutes)
Mapplic can present the same map in several languages — both the interface strings and your own location content. This tutorial walks through setting up a bilingual map end to end. For the reference detail on each field, see the Localization guide.
Enable Localization
In the Modules panel, switch on Localization, then click Configure to open its panel. The language list starts empty — adding the first language activates the interface translations and the per-language fields on each location.
Add languages
Add at least two languages from the built-in list of 80+ options — a map only becomes
multilingual once it has more than one. Each language has a Code — its ISO code,
like en or fr — and that code is the key every translation is stored under.
Mark one language as the default with Set as default; visitors see it until they switch. The Name and Flag you set are shown only inside the builder, not on the live map.
Translate the interface
The Translations list covers fixed interface text — button labels, prompts, and the like. Add an entry, type the Original string, then fill in a value for each language.
The original must match the interface text exactly, including capitalization, or the translation won’t apply.
Translate location content
With localization on, location content is translated per language: pick a language in
the top-bar switcher, then edit the translatable fields — Title, About,
Link, Description, and the Button label. When a non-default language is
active, the field shows its flag and saves under a field_code key (for example
title_fr); the default text appears as the placeholder. Switch back to the default
language to edit the original values.
Open a few locations and fill in their translations for each language.
Test the switch
In the builder, use the language switcher in the top bar to preview each language —
the interface and location content update together. On a live embed there’s no switcher;
the language follows the host page’s <html lang> (see below).
On the embedded map the language is determined by the host page. Mapplic reads its
<html lang> attribute — if it matches one of the map’s languages (region variants like
en-US match en), that translation is shown; otherwise the map falls back to the
default language. It keeps watching the attribute, so the site’s own language switcher
drives the map with no extra setup.
Want to see how translations resolve under the hood? The Localization guide has the field reference, and the Language and Translation schemas show the data shapes.