Localization (Document Authoring Tool)

Use the Document Authoring Tool (da.live) Translation app to translate your storefront content into multiple languages. After translation, complete Commerce-specific tasks for placeholder files and store view verification (see Commerce localization tasks).

Choosing your authoring approach

Two approaches for authoring with Edge Delivery Services:

• Document Authoring (this guide): Content authored on da.live. Simple Translation app workflow (Traverse + Translate).

• AEM Sites Authoring: Content authored in AEM as a Cloud Service. See Localization (Universal Editor) for the AEM translation workflow.

Before translating

Complete the multistore setup to create the folder structure, configure store views, and set up the currency and headers. This guide covers translating the content in those folders.

Prerequisites

• You have a storefront project in the Document Authoring app ( da.live ).
• You know the basics of using the Document Authoring tool ( da.live/docs ).

Additional resources

Edge Delivery Services documentation

• Edge Delivery Services Overview - Adobe Experience League
• Authoring and Publishing Content - Adobe Experience League
• Edge Delivery Services Developer Documentation - aem.live

Translation and localization

• Translation and Localization - aem.live
• Translation, localization, and rollout - da.live

Big picture

The following diagram provides the basic workflow for translating the Edge Delivery content of your storefront into multiple languages using the Document Authoring apps from da.live .

Workflow for localizing your storefront

Step-by-step

These steps provide the details for the translation workflow shown in the diagram. The steps describe how to translate the default English store to another language. In this example, we will translate the default English store to French (fr).

Navigate to the apps page for your storefront

1. Open your storefront project in the Document Authoring tool ( da.live ).
2. Select Apps from the left sidebar.

Use the Traverse app to get a list of site URLs

1. Open the Traverse app by selecting its Go button.
2. On the Crawl Tree page, enter the organization name and site name for your storefront. Example: /acme/storefront. Ensure that you enter a forward slash (/) at the beginning of the string or it will not work.
3. Select the Crawl button to start the crawl.
4. Select the Copy list button after the URLs for the site have been traversed. This puts all the URLs in your clipboard.
5. Return to the Apps page.

Use the Translation app to translate your storefront

1. Open the Translate app by selecting its Go button.
2. On the Localization page, enter the title for the translation project: acme-storefront-fr.
3. Paste the list of URLs from the Traverse app into the URLs field.

   Note

   We recommend excluding certain files—such as metadata.json, redirects.json, and sitemap.json—from the translation process. Adding these files to the translation process shouldn’t cause any technical issues with translation, but translating them is not necessary.

4. Select the Next button.
5. View the validated URLs to ensure that they are all correct.
6. Select the Next button.
7. Select one or more languages you want to translate to. In this example, we will translate to French (fr).
8. For the French language, select Translate from the selector, then select the Create project button.
9. From the project page, select the Send all for translation button.

Translation services

By default, the Translation app uses the Google Translate service to translate the content of the storefront into the selected language. Your organization can also connect other translation services for a more robust translation experience. For more information on translation services and configuration, see Translation and Localization.

View the translated site

1. Navigate back to the main (root) folder for your English storefront.
2. Scroll the site files and folders to find the fr folder and open it.
3. Select a document to view the translated content. For example, select the index document to view the translated home page.

Next steps

After translating your content with the da.live Translation app:

1. Complete Commerce tasks: Follow the Commerce localization tasks guide to:

   • Translate drop-in placeholder files (cart.json, checkout.json, pdp.json)
   • Verify store view configuration aligns with your multistore setup
   • Test Commerce functionality (product data, pricing, currency, store switcher)

2. Review best practices: See Commerce-specific best practices in the Commerce localization tasks guide.

3. Troubleshooting: For Commerce-specific issues, refer to the troubleshooting section in Commerce localization tasks.

Troubleshooting

For da.live Translation app issues, see:

• Translation and Localization - aem.live
• da.live translation documentation - da.live
• Edge Delivery Services Document Authoring - Adobe Experience League

For Adobe Commerce store view configuration issues, see:

• Store view configuration - Adobe Experience League
• Adobe Commerce Configuration Scope - Adobe Experience League