Translations
This page shows you how to create translated versions of your pages and posts so visitors can read your site in their own language. A translation is a separate copy that stays linked to the original, so you can edit each language independently.
Before you start: turn on languages
Translation options only appear once your website supports more than one locale.
- Open your website workspace and go to Settings.
- Open the Localization section.
- Under Supported locales, turn on each language you want to offer.
- Pick a Default locale. This is the language new content starts in.
- Save your settings.
If only one locale is enabled, the Translate option is hidden everywhere.
Translate a page
- In your website workspace, open Pages.
- Find the page you want to translate and open its actions menu (the "..." button).
- Choose Translate, then pick the target language from the submenu.
- You are taken straight into the builder for the new translated page.
The new page starts as a copy of the original, set to draft status. Its slug is the original slug with the language code added (for example about-fr). Edit the content, then publish it when you are ready.
If a translation in that language already exists, choosing it simply opens that existing translation instead of creating a duplicate.
Translate a post
- In your website workspace, open Posts.
- Find the post you want to translate and open its actions menu.
- Choose Translate, then pick the target language.
- The builder opens on the new translated post.
As with pages, the translation is a draft copy with a language-suffixed slug, linked to the original. Edit and publish it separately.
How translations stay linked
When you create the first translation of a page or post, agencms groups the original and its translations together using a shared translation group. Every language version belongs to the same group, which is how the system knows they are the same piece of content in different languages.
Because each translation is a full, independent copy:
- Editing one language never changes another.
- Each language has its own status, so you can keep a translation in draft while the original stays published.
- Each translated page or post counts toward your plan's page or post quota.
Editing across languages
Each language version is edited in its own builder. To switch between languages while editing, open the version you want from the Pages or Posts list and click Translate again to jump to (or create) another language.
On your published site, visitors see a language switcher when a piece of content has more than one published translation. It links each available language version together automatically.
URL and SEO options
The Localization section also controls how translated URLs look and how search engines understand them.
- URL strategy: Choose Flat URLs to keep clean paths, or Locale prefixed URLs to put the language code in the path (for example
/fr/about). - Auto hreflang: Turn this on to emit alternate language links on translated public pages, which helps search engines serve the right language to each visitor.
Set these once and they apply across all your translated content.
Tips
- Translate after the original is finished, so you copy a stable layout into each language.
- Publish translations only when the content is fully translated, since drafts stay private.
- Add every language you plan to offer in Localization first, then translate content into each one.
See also Pages, Posts, and Website settings for related topics.