Skip to content
Mistral Studio

Multiple languages

How to run a site in several languages with Mistral Pro: page translations, the language switcher, and the system pages' built-in English and French.

Updated August 23, 2026 · 3 min read · Applies from version 1.0.0

Mistral Pro contains no hard-coded text: every label a visitor can read is a module field. Translating a site is therefore HubSpot's normal multi-language workflow, with two things to know about the system pages and the language switcher.

Translate pages

  1. In Content → Website Pages, open the page's actions and choose Create variation → language variation (HubSpot's standard multi-language feature), then pick the language.
  2. In the language variant, translate the content of each module: headings, texts, buttons, and the labels groups (Labels, Labels and formats, Accessibility labels) where the small interface strings live — "Read more", "Previous / Next", the reading time suffix, the date format, screen-reader labels.
  3. Do the same for the header and footer if you keep a global header per language, or point their menus at a per-language HubSpot menu.

Every string a module prints is in its fields, so nothing stays in English by accident. Status labels of the method board ("Done", "In progress", "Up next"), the "All" pill of the blog filters, the result count sentences of the search page and the cookie settings button of the footer are all fields.

The language switcher

The header shows HubSpot's language switcher in the top bar and in the mobile menu (Display → Show language switcher, on by default); the footer can show it too (off by default). It lists the translations that exist for the current page, each language written in its own name, and is hidden when the page has no translation.

System and membership pages: English and French built in

The system pages (password prompt, email subscription pages) and the membership pages have no module fields for their copy. Their texts come from one shared file inside the theme, templates/partials/system-i18n.html, which ships English and French and picks the language from the page's language setting: a French page gets French strings automatically.

The error pages (404, 500) and the search results page are different: their copy lives in module fields, edited in the page editor, and their page title follows the same translation file.

Theme settings are global

Colours, fonts and spacing are shared by every language. Only content differs between variants.

See also