Multilingual

The Multilingual screen lets you translate your documentation into additional languages using AI. Each language is stored and published independently, so your English content is never changed. Translated content goes through a draft state before it is made visible to visitors, and you control exactly which languages appear on your public site.

How It Works

Translations are generated by a background job that runs against the content you select. The job tracks progress in the database, so if you navigate away and return, the progress bar resumes from where it left off. Once a translation job finishes, each translated item enters a draft state — it is stored but not yet visible to visitors. A separate publish step makes it live.

Your English source content is never modified by a translation run. Re-translating an item replaces only that language's copy, including any manual edits you made to it. A confirmation dialog appears before any existing translation is overwritten.

The Answer Agent chat widget automatically follows the language a visitor is reading in. If a visitor is browsing your docs in French, the Answer Agent answers in French. You do not configure this separately — it is tied to whichever languages you switch on.

Opening the Multilingual Screen

Open your admin dashboard and select Settings -> Multilingual from the sidebar. The page header shows a globe icon, the Multilingual title, and a count of how many languages are currently published on your public site, with a flag icon for each.

Selecting a Language

Use the language dropdown at the top of the content panel to choose which language you are working with. Everything below it — the public toggle, the stats cards, and the pages table — is scoped to the language you select here. The dropdown shows a flag and the language name for each available language. A green dot next to a language in the list means it is currently live on your public site.

Making a Language Public

Below the language dropdown is the public visibility toggle. This single switch controls whether visitors can read your site in the selected language.

The toggle has three states:

•Locked — the language has no translated content yet. The toggle is disabled and shows a Locked badge. Translate at least one page to unlock it.

•Hidden — the language has translated content but is not shown to visitors. Turn the toggle on to add it to the language switcher on your public site.

•Live — the language is active on your public site. Visitors can switch to it using the language switcher. A link to the public URL for that language appears below the toggle so you can verify it directly.

Turning a language off hides it from visitors without deleting any translation. You can turn it back on at any time.

Content Tabs

Three tabs let you work on different content areas independently. Switching tabs changes which items appear in the stats and pages table below.

•Docs — your documentation pages and folders.

•Changelog — your changelog entries.

•API Reference — your API reference categories and endpoints.

Translation Stats

Three stat cards appear below the tabs, scoped to the active tab and selected language. These counts reflect the full scope, not just the current page of the table.

•Translated to [language] — shows how many items have been translated out of the total (e.g. 4/12).

•Published — the number of translated items that are live on your public site.

•In draft — translated items that have not been published yet. These are finished translations waiting to go live.

The Pages Table

The pages table lists every translatable item in the active tab. Each row shows the item's name, its translated name (if one exists), and a status badge.

Status badges in the table:

•Not translated — no translation exists for this item in the selected language.

•Draft — the item has been translated but not yet published.

•Published — the translated version is live on your public site.

Filtering and Searching

Filter chips above the table let you narrow the list. Each chip shows a count of how many items match.

•All pages — shows every item in the scope.

•Not translated — shows only items with no translation yet.

•Published — shows only items whose translation is live.

•Draft — shows only translated items waiting to be published.

Use the Search pages... field to find a specific item by name. The search is debounced and runs on the server, so results update automatically as you type.

Per-Row Actions

Each row in the table has action buttons on the right side, depending on the item's current status.

•Translate to [language] — appears on rows that have not been translated yet. Clicking it starts a translation job for that single item without affecting your checkbox selection.

•Publish — appears on rows that are translated but still in draft. Clicking it publishes only that item.

•Edit in [language] — appears on translated rows in the Docs and Changelog tabs. Clicking it opens the admin editor already switched to the selected language, so you land directly on the translated copy.