Configure the integration

Last update: July 9, 2025

CREATED FOR:

  • User

Configure the integration by connecting Commerce to the AEM Assets instance and selecting the matching strategy for asset synchronization.

After identifying the AEM Assets project, select the matching rule for synchronizing assets between Adobe Commerce and AEM Assets.

  • Match by product SKU—Default rule that matches the SKU in the asset metadata with the Commerce product SKU to ensure that assets are associated with the correct products.

  • Custom match—Matching rule for more complex scenarios or specific business requirements that require custom matching logic. Implementing custom matching requires developing custom code in Adobe Developer App Builder to define how assets are matched with products. More details coming soon…

For the initial setup, use the default Match by product sku rule.

Prerequisites

  • Install AEM Assets package

  • PaaS only Install Adobe Commerce packages to add the extension and generate the required credentials and connections to use the extension.

  • Follow the steps described in the enable Dynamic Media Open API topic. Include the following information for the support team:

    • AEM Program ID
    • Adobe Commerce URL
    • AEM Environment ID,
    • IMS Org ID for the AEM Assets Authoring environment that you want to connect to Commerce.

Configure the connection

  1. Get the AEM Assets Authoring Environment project and environment ID.

    1. Open the AEM Cloud Manager and select Assets.

    2. Copy and save the project and environment IDs from the URL:
      https://author-p[Program ID]-e[EnvironmentID].adobeaemcloud.com/

  2. From the Commerce Admin, open the AEM Assets Integration configuration.

    1. Go to Store > Configuration > ADOBE SERVICES > AEM Assets Integration.

      AEM Assets Integration enable the integration

  3. Enter the AEM Assets environment Program ID and Environment ID.

    Edit the configuration values by removing the selection from Use system value.

  4. Enter the Asset Selector IMS Client ID.

    For details about the Asset Selector, see Manually selecting assets

  5. PaaS only Select the Commerce integration for authenticating requests between Commerce and the asset matching service.

  6. Set Integration enabled to Yes to allow Commerce to accept incoming updates from AEM Assets.

    After enabling the integration, additional configuration options are available to specify asset matching criteria.

  7. Select one of the asset matching rules for asset synchronization from the Asset matching rule dropdown.

  8. Add the AEM Assets metadata field name defined for Commerce product SKUs in the Match by product SKU attribute name field, commerce:skus by default.

  9. Select Save Config to apply updates and initiate asset synchronization.

    The configuration update triggers the initial synchronization process, allowing Commerce to accept incoming updates from AEM Assets. The time required for synchronization depends on the volume of assets and specific configurations. The integration leverages automated processes to minimize the time required for synchronization.

Synchronization SLA

The integration guarantees the following synchronization performance levels:

  • < 5 minutes for 99% of updates

  • < 30 minutes for 99.9% of updates

This ensures that product pages always display the most up-to-date images, keeping storefront content accurate and visually appealing.

Optional. Configure the Custom Domain URL

If the AEM Assets as a Cloud Service project has been configured with a Custom Domain Name, you must add the domain name to the Commerce store configuration so that the AEM Assets integration for Commerce can use it.

  1. Navigate to Store > Configuration > ADOBE SERVICES > AEM Assets Integration.

    AEM Assets Integration enable the integration

  2. Add the Custom Domain URL to the Asset Custom Domain field.

  3. Click Save Config to apply updates and initiate asset synchronization.

Next step

Manage Commerce assets

recommendation-more-help