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 — Danish
  • fr — French
  • es — Spanish

How the locale is chosen

When the widget opens, Gatherly picks a language in this order:

  1. data-language on the embed script, if it is a supported code and the project is on a paid plan
  2. The project’s default language (set in Project → Widget)
  3. 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:

html
<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-language is 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-language is omitted.
  • Widget editor → Text — edit customizable header copy (greeting and title) per language. Switch language pills to preview and save each locale.

Related