Types of translatable text

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

1. Editorial content



2. User interface labels


Message bundle for user interface labels

3. Template labels


Message bundle for template labels

Best practice

Avoid hard-coded strings exposed to visitors, editors or administrators. Always allow localization of texts displayed on the website and in Magnolia Shell.

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

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:

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.

We run the internationalization effort as a community project so please check out the Language Bundles project in JIRA and help out!

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

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

Template labels on an article page

Best practice

Separate message bundles

Create separate message bundles for user interface labels and template labels. Don’t store these two groups of text in the same properties files or message bundles. They are aimed at different audiences and have different localization requirements.

Example: Message files in the Travel Demo


DX Core



This widget lets you know where you are on the docs site.

You are currently perusing through the DX Core docs.

Main doc sections

DX Core Headless PaaS Legacy Cloud Incubator modules
6.3 beta

Magnolia 6.3 beta

Magnolia 6.3 is in beta. We are updating docs based on development and feedback. Consider the 6.3 docs currently in a state of progress and not final.

We are working on some 6.3-beta known issues during this phase.