Skip to content
Capell CMS

Using Translation Manager

This guide is for editors who translate content and owners deciding which languages to support. Every step uses the labels you see on screen.

Using Translation Manager (editor how-to)

Section titled “Using Translation Manager (editor how-to)”

How to choose translation work

Section titled “How to choose translation work”
  1. Go to Translation Manager and choose Translate into for the locale you want to complete.
  2. Review the locale work queue. It shows Missing, Stale, Changed, Extra, Fallback, and Ready counts.
  3. Click Continue translating to open the next actionable file and key. The order is stable: missing, stale, then changed, followed by file and key order.
  4. File work starts at Needs attention. Use Advanced filters and tools when you need to inspect complete entries or specialist source/file controls.

How to add a locale

Section titled “How to add a locale”
  1. Go to Translation Manager.
  2. Open Advanced filters and tools, then choose Create locale and choose the language.
  3. Save. You can now translate content into it.
A translator opens the Create locale action to add a new target locale. A translator opens the Create locale action to add a new target locale.

How to start a locale from an existing one

Section titled “How to start a locale from an existing one”
  1. In Translation Manager, open Advanced filters and tools, then click Duplicate locale.
  2. Choose the Source locale to copy strings from, and the new target locale.
  3. Save. The new locale starts with the copied strings so you only have to adjust what differs.
A translator opens the Duplicate locale action to copy strings from an existing locale. A translator opens the Duplicate locale action to copy strings from an existing locale.

How to edit a translation

Section titled “How to edit a translation”
  1. Open the translation editor for your locale, or use Continue translating from the work queue.
  2. Edit each translation side by side with the original Source text. The status of each entry (for example Missing or Changed) is shown next to it.
  3. Save as you go.
A translator reviews source strings beside editable target strings, status, and selection controls. A translator reviews source strings beside editable target strings, status, and selection controls.

How to find what still needs translating

Section titled “How to find what still needs translating”
  1. Open Advanced filters and tools and use the Missing filter, or keep the default Needs attention view.
  2. It shows the content that has no translation yet in your locale. When nothing matches, the source, locale, file, and filter controls stay on screen so you can change your view.
  3. Work through the list before launch.
An administrator filters the current file to a state with no matching rows and still sees the source, locale, file, and filter controls. An administrator filters the current file to a state with no matching rows and still sees the source, locale, file, and filter controls.

How to draft translations with AI

Section titled “How to draft translations with AI”
  1. Select the entries you want drafted.
  2. Open Advanced filters and tools, then use Translate selected to draft target values for them. This is available when an AI translator is set up for your site.
  3. Review every suggestion, then accept or reject it individually.
  4. Use Save to keep the accepted suggestions.
A translator runs the Translate selected action when an AI translator is available. A translator runs the Translate selected action when an AI translator is available.

How to import or export translations

Section titled “How to import or export translations”
  1. First choose the Translate into locale. Open Advanced filters and tools when you need a Source, Source locale, or translation File.
  2. To bring in translations for that selected file, use Import translations, choose CSV, PO, or XLIFF, then paste the translated contents into the form.
  3. To send out that selected file, use Export CSV, Export PO, or Export XLIFF.
  4. Save this file is the primary action. The page shows the number of unsaved entries and offers Save and continue, Discard and continue, or Stay here before locale, source, or file navigation.

Rolling out Translation Manager (for owners)

Section titled “Rolling out Translation Manager (for owners)”

Turn on first

Section titled “Turn on first”
  • One additional language, fully covered. Pick your most important second language and complete it before adding more.

Add when needed

Section titled “Add when needed”
NeedEnable
More languagesAdditional locales, one at a time
Work with external translatorsExport and Import in their preferred format

Don’t enable yet

Section titled “Don’t enable yet”
  • Don’t launch a language with big gaps. Use the Missing filter to finish coverage first.

Who does what

Section titled “Who does what”
RoleFirst useful screen
Translator / editorThe translation editor and the Missing filter
Site ownerLocales: decide which languages to support

Troubleshooting for editors

Section titled “Troubleshooting for editors”
What you seeWhat it meansWhat to do
A page shows in the wrong languageIt isn’t translated for that localeFind it via the Missing filter and translate it
Coverage looks incompleteSome strings have no translationWork through the Missing list
An import didn’t applyThe file format didn’t matchRe-export in the right format, then Import contents
Translations look out of dateThe source text changed after translatingRe-check the side-by-side editor and update the translation