Setup Translation Rules

The Translation Configuration UI allows a user to manage rules for translating content in AEM Sites. This video details the creation of a new translation rule for a custom component.


The video below was recorded on AEM 6.3. AEM 6.4+ introduces a new repository structure for storing the translation rules XML file. When using the Translation Configuration UI in AEM 6.4+ the rules are saved to the location /conf/global/settings/translation/rules/translation_rules.xml. See Identifying Content to Translate for more details.

Translation rules identify content in AEM to be extracted for translation. Out of the box translation rules cover common use cases such as Text components and alt text for Image components. Depending on a projects translation requirements additional rules may be need. In general translation rules allow users to specify:

  1. Properties that should be translated based on path and/or resource type
  2. Filters for properties that should NOT be translated
  3. Referenced content that should be translated (i.e Images or Content Fragments)

The translation rules editor that will update the translation xml file. The Translation Configuration UI makes it easier to manage various translation rules and guards against typos when editing XML directly.

Access the Translation Configuration UI:

Prior to AEM 6.3

In prior AEM version translation rules were manually updated by editing an XML file located under the Translation workflow: /etc/workflow/models/translation/translation_rules.xml.

Additional Resources

On this page