Documentation
Multi-language
Default language, data-language, and per-locale widget copy.
Overview
The embed widget can show built-in UI and your custom header copy in more than one language. Visitors get the right locale from the project’s default language, or from an optional data-language attribute on the embed script.
Multi-language is available on Starter, Growth, and Scale. Free projects always render English.
Supported languages
Currently available locales:
en— English (default)da— Danishfr— Frenches— Spanish
How the locale is chosen
When the widget opens, Gatherly picks a language in this order:
data-languageon the embed script, if it is a supported code and the project is on a paid plan- The project’s default language (set in Project → Widget)
- English (
en)
Missing or incomplete custom copy for a language falls back the same way: requested locale → default language → English. Built-in UI strings (buttons, form labels, chat chrome, and so on) ship with each supported language in the product.
data-language
Pass an optional ISO language code on the script tag to force that locale for the page (or app shell) where the script is installed:
<script
src="https://your-gatherly-app/embed.js"
data-key="pk_live_…"
data-language="da"
async
></script>- Omit the attribute to use the project default language.
- Unsupported codes are ignored; Gatherly falls back to the default, then English.
- On Free,
data-languageis ignored and the widget stays in English.
Different pages can use different codes (for example en on an English marketing site and fr on a French product). That does not change the project default — it only overrides for that install.
Configure in the dashboard
- Project → Widget — set the default language used when
data-languageis omitted. - Widget editor → Text — edit customizable header copy (greeting and title) per language. Switch language pills to preview and save each locale.
Related
- Install the widget — script attributes including
data-keyanddata-language - Dashboard — project and widget settings overview