Preparing Assets for Translation preparing-assets-for-translation

AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

Multilingual assets means assets with binaries, metadata, and tags in multiple languages. Generally, binaries, metadata, and tags for assets exist in one language, which are then translated to other languages for use in multilingual projects.

In Adobe Experience Manager Assets, multilingual assets are included in folders, where each folder contains the assets in a different language.

Each language folder is called a language copy. The root folder of a language copy, known as the language root, identifies the language of the content in the language copy. For example, /content/dam/it is the Italian language root for the Italian language copy. Language copies must use a correctly-configured language root so that the correct language is targeted when translations of source assets are performed.

The language copy for which you originally add assets is the language primary. The language primary is the source that is translated into other languages.

The sample folder hierarchy includes several language roots:

    /- dam
             |- en
             |- fr
             |- de
             |- es
             |- it
             |- ja
             |- zh

Perform the following steps to prepare your assets for translation:

  1. Create the language root of your language primary. For example, the language root of the English language copy in the sample folder hierarchy is /content/dam/en. Ensure that the language root is correctly configured according to the information in Creating a Language Root.

  2. Add assets to your language primary.

  3. Create the language root of each target language for which you require a language copy.

Creating a Language Root creating-a-language-root

To create the language root, you create a folder and use an ISO language code as the value for the Name property. After you create the language root, you can create a language copy at any level within the language root.

For example, the root page of the Italian language copy of the sample hierarchy has it as the Name property. The Name property is used as the name of the asset node in the repository, and therefore determines the path of the assets. (https://[AEM_server]:[port]/assets.html/content/dam/it/*)

  1. From the Assets console, click/tap Create and choose Folder from the menu.


  2. In the Name field type the country code in the format of <language-code>.


  3. Click or tap Create. The language root is created in the Assets console.

Viewing Language Roots viewing-language-roots

The touch-optimized UI provides a References panel that shows a list of language roots that have been created within Experience Manager Assets.

  1. In the Assets console, select the language primary for which you want to create language copies.

  2. Click or tap the GlobalNav icon, and choose References to open the Reference pane.


  3. In the References pane, click or tap Language Copies. The Language Copies panel shows the language copies of the assets.