OptimoCMS Docs
Back to overview

Translations

Multilingual websites: set up languages, translate pages and understand the translation process.

Enabling languages

Go to Settings → Languages to configure multilingual support: 1. Choose a default language (e.g. English) 2. Add extra languages via the "Add language" dropdown 3. Set the fallback behaviour: • Show default language – if a translation is missing, show the default language • Hide – pages without a translation are hidden for that language • Show original – show the untranslated content with an indicator 4. Click Save You can enable up to 10 languages per website.
Tips
  • Start with 1-2 extra languages. You can always add more later.
  • The default language is shown to visitors who have no language preference.

Translating a page

Once you have enabled multiple languages, a language button (flag) appears in the page editor. Click it to: • View existing translations (green tick) • Create an empty translation ("Create translation") • Auto-translate with AI ("Auto-translate") With "Create translation" you get an empty copy of the page in the target language. With "Auto-translate" all text is automatically translated by AI.
Tips
  • Auto-translate translates text, titles and SEO fields in one go.
  • Always review the translation after auto-translating – AI is good but not perfect.

How auto-translate works

The auto-translate process follows these steps: 1. All text fields are extracted from the page (titles, headings, body text, buttons, etc.) 2. Structure, images, layouts and styling remain unchanged 3. All texts are sent to AI (OpenAI) in a single request 4. AI translates the texts while preserving HTML formatting 5. URLs, email addresses and brand names are NOT translated 6. The translated texts are placed back into the page structure 7. A new page is created as a draft in the target language The result opens automatically in the editor so you can review and adjust it.
Note
  • Auto-translate is available from the Professional plan. Starter cannot auto-translate.
  • Daily limit per tier: Professional = max 20/day, Agency = max 20/day.
  • AI content actions per day (incl. translations): Starter = 50, Professional = 150, Agency = 300.
  • At 80% of your limit a warning appears in the language button. At 100% auto-translate is blocked until the next day.

Managing translations

Translated pages are linked via a translation group ID. This means: • All translations of the same page are linked together • Via the language button you can quickly switch between language versions • Each translation has its own slug (e.g. "about-us-de" for the German version) • Translations are independently editable – a change in one language does not affect the other You can publish translations separately. A draft translation is not visible on the live website.
Tips
  • Give translated pages a clear slug in the target language for better SEO.
  • Only publish translations once you have reviewed them.

How visitors see the right language

On the live website the language is determined automatically: 1. The visitor's browser language preference is detected 2. If a translation is available in that language, it is shown 3. If no translation exists, the fallback behaviour you configured applies 4. Visitors can manually switch language via the language switcher on the website The language switcher only shows languages for which translations are actually available.

Call us