Configure Translation Rules
Learn how to define translation rules to identify content for translation.
The Story So Far
In the previous document of the AEM headless translation journey, Configure translation integration you learned how to install and configure your translation integration and should now:
- Understand the important parameters of the Translation Integration Framework in AEM.
- Be able to set up your own connection to your translation service.
Now that your integration is set up, this article takes you through the next step of identifying what content you need to translate.
Objective
This document helps you understand how to use AEM’s translation rules to identify your translation content. After reading this document you should:
- Understand what the translation rules do.
- Be able to define your own translation rules.
Translation Rules
Content Fragments, which represent your headless content, can contain much information organized by structured fields. Depending on your project needs, it is likely that not all the fields within a Content Fragment must to be translated.
Translation rules identify the content that is included in, or excluded from, translation projects. When content is translated, AEM extracts or harvests the content based on these rules. In this way only content that must be translated is sent to the translation service.
Translation rules include the following information:
- The path of the content to which the rule applies
- The rule also applies to the descendants of the content
- The names of the properties that contain the content to translate
- The property can be specific to a specific resource type or to all resource types
Because Content Fragment Models, which define the structure of your Content Fragments, are unique to your own project, it is vital to set up translation rules so AEM knows what elements of your content models to translate.
TIPCreating Translation Rules
Multiple rules can be created to support complex translation requirements. For example, one project you may be working on requires all fields of the model to be translated, but on another only description fields must be translated while titles are left untranslated.
Translation rules are designed to handle such scenarios. However in this example we illustrate how to create rules by focusing on a simple, single configuration.
There is a Translation Configuration console available for configuring translation rules. To access it:
- Navigate to Tools > General.
- Click Translation Configuration.
In the Translation Configuration UI, there are several options available for your translation rules. Here we highlight the most necessary and typical steps required for a basic headless localization configuration.
-
Click Add Context, which lets you add a path. This is the path of the content that is be affected by the rule.
-
Use the path browser to select the required path and click the Confirm button to save. Remember, Content Fragments, which hold headless content, are generally located under
/content/dam/<your-project>.
-
AEM saves the configuration.
-
Select the context you created and then click Edit. This opens the Translation Rules Editor to configure the properties.
-
By default all configurations are inherited from the parent path, in this case
/content/dam. Uncheck the option Inherit from/content/damto add additional fields to the configuration. -
Once unchecked, under the General section of the list, add the property names of the Content Fragment Model(s) that you previously identified as fields for translation.
- Enter the property name in the New Property field.
- The options Translate and Inherit are checked automatically.
- Click Add.
- Repeat these steps for all the fields that you must translate.
- Click Save.
You have now configured your translation rules.
Advanced Usage
There are several additional properties that can be configured as part of your translation rules. In addition, you can specify your rules by hand as XML, which allows for more specificity and flexibility.
Such features are generally not needed to get started localizing your headless content, but you can read about them further in the Additional Resources section if you are interested.
What’s Next
Now that you have completed this part of the headless translation journey you should:
- Understand what the translation rules do.
- Be able to define your own translation rules.
Build on this knowledge and continue your AEM headless translation journey by next reviewing the document Translate content where you will learn how your integration and rules work together to translate headless content.
Additional Resources
While it is recommended that you move on to the next part of the headless translation journey by reviewing the document Translate content, the following are some additional, optional resources that do a deeper dive on some concepts mentioned in this document, but they are not required to continue on the headless journey.
- Identifying Content to Translate - Learn how translation rules identify content that needs translating.
Experience Manager
Driving Marketing Agility and Scale: Transforming your Content Supply Chain with AI
Marketers everywhere are feeling the pressure to deliver impactful campaigns faster and at greater scale. This Strategy Keynote explores...
Tue, Mar 18, 2:30 PM PDT (9:30 PM UTC)
The True Cost of a Failed Implementation
A failed implementation isn’t just an inconvenience — it costs real revenue. Poor execution and misaligned tools disrupt pipelines,...
Wed, Mar 19, 2:00 PM PDT (9:00 PM UTC)
Connect with Experience League at Summit!
Get front-row access to top sessions, hands-on activities, and networking—wherever you are!
Learn more