Configure the integration

Last update: June 18, 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.