The 5.7 branch of Magnolia reached End-of-Life on December 31, 2023, as specified in our End-of-life policy. This means the 5.7 branch is no longer maintained or supported. Please upgrade to the latest Magnolia release. By upgrading, you will get the latest release of Magnolia featuring significant improvements to the author and developer experience. For a successful upgrade, please consult our Magnolia 6.2 documentation. If you need help, please contact info@magnolia-cms.com.
You should make all text displayed to website visitors and editors translatable. This page explains what text in Magnolia is translatable and where it is stored.
There are three major groups of translatable text:
Translatable text | Audience | Stored in |
---|---|---|
Visitors | JCR | |
2. User interface labels | Editors | Message bundle for user interface labels |
3. Template labels | Visitors | Message bundle for template labels |
Editorial content
Editorial content is the biggest group of translatable text. It is the main content of your website, aimed at site visitors.
Editors write editorial content in the Pages app and other content apps. All editorial content is stored in JCR, mainly in the website
workspace, but apps can also store content in a custom workspace. All editorial content can be translated as part of the content creation process. If your website serves visitors from several countries and languages, this is the bulk of your translation effort.
Example: Editorial content on an article page
User interface labels
UI labels is the second largest group of translatable text. Labels are displayed to editors and administrators in the Magnolia Shell (AdminCentral). This group includes:
- Field labels and descriptions
- Messages (alerts, warnings, information)
- App UI elements such as workbenches, columns, forms and actions.
- Buttons in the page editor in edit mode, used to open dialogs
We sometimes refer to this text as "dialog labels" but it is not limited to dialogs. You also find labels in actions and other UI elements. 99% of all text you see in the Magnolia Shell belongs to this group.
User interface labels are stored in message bundles. Magnolia provides translated UI labels for its native apps. You should make your own app translatable too. Translation of user interface text is a community project coordinated by Magnolia International.
The languages exposed to the website visitors may be different from the languages editors and administrators use in Magnolia Shell (AdminCentral). For this reason, editorial content and UI labels are stored in a different places using different mechanisms.
Example: User interface labels
Template labels
Template labels is the smallest group of translatable text. This rare kind of text is displayed to visitors but it is not editable by Magnolia editors. Examples of template labels are the cookie crumb label "You are here" and login and logout links.
You should store your template labels in their own message bundle, not in the same bundle as user interface labels. This text is aimed at site visitors, not at editors, so it has the same localization requirements as content. Template labels need to be translated to the same languages as the public website.
Example: Template labels on an article page