Language Dictionaries

The AEM internationalization framework uses dictionaries in the repository to store English strings and their translations in other languages. The framework uses English as the default language. Strings are identified using their English version. Typically, internationalization frameworks use alphanumeric IDs for UI strings. Using the English version of the string as the ID has several advantages:

  • Code is easy to read.
  • The default language is always available.

The Translation tool enables you to manage all dictionaries from one central location.

i18n-components-2

Translation changes need to come from Git via the CI/CD pipeline in AEM as a cloud service.

Overlaying Strings in System Dictionaries

If your components use strings that are included in the AEM system dictionaries, duplicate the string in your own dictionary. All components will use the strings from your dictionary.

Note that you cannot predict which translation is used when strings are duplicated in dictionaries that are all located below the /apps node.

recommendation-more-help