Documentation Commerce AEM Assets Integration

Configure your Storefront

Last update: May 11, 2026

CREATED FOR:

User

Enable product-image display from AEM Assets enable-product-images

The AEM Assets integration displays product images from AEM Assets instead of Adobe Commerce, enabling advanced optimization, cropping, and CDN delivery.

To enable the integration in Commerce storefronts powered by Edge Delivery Services, add the "commerce-assets-enabled": true parameter to the storefront configuration file (config.json).

{
  "public": {
    "default": {
      "commerce-assets-enabled": true
    }
  }
}

The Commerce drop-ins automatically detect the commerce-assets-enabled configuration and adjust image handling accordingly.

For more information on using AEM Assets with the Commerce Storefront powered by Edge Delivery Services, see the AEM Assets integration topic in the Adobe Commerce Storefront documentation.

TIP

To let authors browse and insert AEM Assets into static content pages, see Connect AEM Assets to Da.live for static content authoring.

Connect AEM Assets to Da.live for static content authoring connect-aem-assets-authoring

NOTE

This setup is separate from the AEM Assets Integration extension. Provided by Da.live it allows authors to browse and insert AEM Assets into static content pages (for example, landing pages or content blocks) through the Library panel and Content Advisor. Product images synchronized through the AEM Assets Integration are configured separately using the commerce-assets-enabled setting.

Use the following steps to connect AEM Assets to a Document Authoring (Da.live) storefront so that authors can browse and insert AEM Assets from the Content Advisor while editing static content.

NOTE

For detailed setup instructions, see Setup AEM Assets in the Da.live documentation and Integrate AEM Assets while authoring content for Edge Delivery Services in the AEM Assets documentation.

Step 1: Open your site config in Da.live

From Da.live, locate and open your storefront.
In the breadcrumb navigation, select the Settings icon next to your site name to open the site config spreadsheet.

Step 2: Copy your AEM repository URL

In a new tab, go to experience.adobe.com and navigate to Experience Manager.
Open Adobe Experience Manager Assets: Scroll to the My Authoring section, and then select Assets next to your Production environment.
From the browser address bar, copy the segment that starts with author up to and including .com—for example, author-p107634-e1009805.adobeaemcloud.com.

Step 3: Add the repository ID to your config

To configure your site, return to Da.live and select data in your site config.

Complete the spreadsheet as follows:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Cell	Value
A1	`key`
B1	`value`
A2	`aem.repositoryId`
B2	The URL that you copied in Step 2

Select Save, then select the back arrow next to your site name to return to the site root.

note
NOTE
The `author-` prefixed host browses assets from the author tier. To deliver assets through Dynamic Media instead, use a `delivery-` prefixed host. For all `aem.repositoryId` options, see Setup AEM Assets.

Step 4: Connect AEM Assets through the Library

From the site root, select the index folder to open it.
In the editor, open the Library panel and select AEM Assets.

The Content Advisor popover opens and shows your AEM Assets folders and files.

Your storefront is now connected to AEM Assets. You can browse and insert assets directly from the Content Advisor.

AEM Assets integration in the Adobe Commerce Storefront documentation—storefront configuration and image-handling behavior.
Integrate AEM Assets while authoring content for Edge Delivery Services in the AEM Assets documentation.
Setup AEM Assets and Working with media in the Da.live documentation.

recommendation-more-help

commerce-help-aem-assets-integration