Docs Core Concepts Multi-language

Multi-language

A site can serve the same pages in more than one language. The model is a text overlay, not page copies: one page is one layout, built and maintained once, and each language carries only its translated words. You design the page once, and changing the design changes every language at the same time.

How it works

  • You declare the site's languages (a default plus any others) in the
  • Translations screen.

  • The layout, images, 3D and settings are shared across all languages.
  • Only visitor-facing text (headings, body, buttons, labels, captions) is translated.

  • At render time the active language's text is laid over the shared page. The
  • default language returns the page unchanged, so single-language sites are completely unaffected.

URLs and search

  • The default language uses clean URLs (/, /shop). Every other language is
  • served under a prefix: /de/, /de/shop, /en/shop.

  • hreflang alternates are emitted automatically for every language, so
  • search engines serve the right language in each market.

  • A language switcher appears automatically so visitors can change
  • language; the page stays the same, only the words change.

Translating a page

  • Open Translations, pick a page and a language, and every translatable string
  • is listed with its original text beside an editable field. Edits autosave.

  • Auto-translate empty drafts translations for the empty fields with AI and
  • never overwrites text you have already written. You review it afterwards.

Building pages on a multilingual site

Build or generate the page once, in the default language. Never build a separate page tree per language: the languages are an overlay on the one tree, so a second copy would double the maintenance and break the switcher and hreflang. Add the languages in Translations after the page exists.