Multilingual Content

Once a second language is active, you can write your own content in it. Pages, blog posts, categories and tags — and the items of the Booking module — each keep one version per language, side by side.

Before you start

Content can only be translated into active languages. Add and switch on a language in Languages first. The default language is your base version; every other language is a translation of it.

What can be translated

ContentWhereHow you translate it
PagesPages → Manage PagesA flag column for each extra language: + adds the translation, the pencil edits it. The page content is then edited in the Page Builder for that language.
Blog postsPostsA tab for each language on the post form: title, content, excerpt and search details.
Categories and tagsPosts → Categories / TagsOne set of name, title, description and meta fields per language on the form.
Booking itemsBookingServices, service categories, extras, packages, locations, taxes, staff profiles, forms, custom fields, events, customer groups, statuses and notification templates have language tabs on their forms.
Interface textTranslationsButtons and labels, not your content.

What stays the same in every language

Some details belong to the item, not to a language: the page status, the author, a post’s categories, tags and featured image, prices, durations, schedules and stock. Change them once and every language follows.

Translating a page

The Manage Pages list with flag columns for Spanish, French and Turkish and plus signs for adding translations

With several languages active, the Pages list gets a flag column for each. The green + adds a translation.

  1. Open Pages → Manage Pages.
  2. In the row of the page, choose the green + under the flag of the language. The Page Builder opens for that language, starting from the default-language design.
  3. Replace the text and pictures with the translation and choose Save Content. The translation now exists, and the + becomes a pencil you can use to edit it later.
  4. Open Page Settings (the gear) and fill in the title, excerpt and search details in the language tab.

The pencil in the Action column always edits the default language. If a page has no translation for a visitor’s language, TruCMS shows the default-language version instead of an empty page.

Translating a blog post

The Edit Post form with English, Spanish and French tabs above it

Posts have a tab per active language. The right-hand column is shared by all languages.

Open the post and choose the language tab. Write the title, content, excerpt and search details for that language. A tab left empty simply has no translation: visitors in that language see the default-language version.

Addresses and the language switcher

VersionAddress
Default language (English)https://your-site.com/about
Spanishhttps://your-site.com/es/about
Frenchhttps://your-site.com/fr/about

The visitor chooses a language with the language switcher; TruCMS then keeps them in that language while they browse.

Good practice

Troubleshooting

SymptomWhat to do
No language tabs or flags appearOnly one language is active. Switch on another in Languages, and clear the cache if it still does not appear.
The translated page is still in EnglishThe page has no translation yet (the flag shows +), or the translation was saved with the English text. Edit its content for that language.
The wrong language is shownVisitors keep the language they last chose. Use the language switcher, or the language prefix in the address.
A translated address returns “not found”The language is switched off, or the page status is off.

Languages · Translations · Pages · Blog Posts