Translating Items
Translating Selected Items
Use the checkboxes in the table to select the items you want to translate, then click the Translate [n] to [language] button in the toolbar above the table.
•Select the items you want to translate using the checkboxes in the table. Checking a folder automatically selects everything nested inside it.
•If you have selected all visible rows and there are more rows on other pages, a Select all [n] pages link appears. Click it to escalate your selection to every item the current filter matches — including rows you have not downloaded.
•Click Translate [n] to [language] to queue the job. If any selected items already have a translation, a confirmation dialog appears before the job starts, warning that re-translating will replace the existing translation including any manual edits.
•Confirm by clicking Re-translate, or cancel to keep the existing translation.
Translating a Single Item
Click Translate to [language] on any individual row to translate just that item without using the checkboxes. The button changes to Translating… while the job runs. If the item already has a translation, the same overwrite confirmation dialog appears first.
Translation Progress
While a translation job is running, a progress bar appears between the stats cards and the table. It shows:
•The target language's flag and the message Translating into [language]…
•A completed/total counter (e.g. 3/10) scoped to the items you selected, not the backend's internal count.
•A progress bar that fills as items complete.
•If any items could not be translated, a note appears below the bar: [n] item(s) could not be translated and kept their English content.
You can navigate away while a job is running. When you return to the Multilingual screen, the progress bar resumes from the correct position because progress is stored in the database, not in the browser.
Publishing Translations
Translating an item puts it into draft. Publishing is a separate step that makes the translation visible to visitors. There are three ways to publish.
•Publish all — the button in the top-right of the table header. Publishes every translated-but-unpublished item in the active tab for the selected language in one action. The button is disabled when there are no draft items.
•Publish [n] selected — appears in the toolbar when you have checked rows that include at least one translated item. Publishes only the checked rows. Rows that are not yet translated are skipped.
•Publish (per row) — the green Publish button on an individual draft row. Publishes only that one item.
Plan Limits and Language Add-ons
Your plan includes a set number of languages. A language slot is consumed the first time you either translate content into it or switch it on for the public site — whichever happens first. Re-translating or re-publishing a language you have already used does not consume an additional slot.
If you attempt to translate into or publish a new language that would exceed your plan's limit, a dialog appears showing how many languages are in use versus your plan's total. From this dialog you can:
•Click Buy a language to purchase an individual language add-on at a monthly per-language price (available on eligible plans).
•Click the upgrade action to move to a higher plan with a larger language allowance.
•Free workspaces see an upgrade banner at the top of the Multilingual screen. The controls remain active — the limit dialog appears on click rather than disabling the buttons.
Steps to Translate and Publish a Language
•Open the admin dashboard and select Multilingual from the sidebar.
•Use the language dropdown to select the language you want to translate into.
•Select a content tab — Docs, Changelog, or API Reference — to choose which area to work on.
•Use the filter chips or Search pages... field to find the items you want to translate.
•Check the items you want to translate, or use Select all [n] pages to include every matching item.
•Click Translate [n] to [language]. If prompted to confirm an overwrite, click Re-translate to proceed.
•Watch the progress bar until the job completes. Review the translated items in the table — their status will show Draft.
•Click Publish all to publish every draft in the tab, or select specific rows and click Publish [n] selected.
•Turn on the Show [language] toggle to make the language available to visitors on your public site.
•Verify the result by clicking the public URL link that appears below the toggle.
Editing a Translation Manually
For Docs and Changelog items, translated rows show an Edit in [language] button. Clicking it opens the admin editor already switched to the selected language, so you are editing the translated copy rather than the English source. Changes autosave. Use the publish bar inside the editor to take your edits live without returning to the Multilingual screen.
Re-translating an item that you have manually edited will replace your edits with a fresh AI translation. The overwrite confirmation dialog reminds you of this before the job starts.
