Product Visuals with AEM Assets

Last update: May 8, 2026

CREATED FOR:

Admin
Developer

Product Visuals enables Adobe Commerce Optimizer merchants to manage product images through Adobe Experience Manager (AEM) Assets. This integration provides a seamless workflow for syncing high-quality product imagery from AEM Assets to your Commerce Optimizer catalog using catalog layers.

NOTE

Product Visuals is the name of the bundle provided with Adobe Commerce as a Cloud Service and Adobe Commerce Optimizer. It combines Dynamic Media with OpenAPI capabilities and AEM Assets Prime.

Customers with a different AEM Assets license (for example, AEM Assets Ultimate) can use the same integration; only the AEM release affects the onboarding steps, not the license type.

Key benefits

Centralized asset management: Manage all product images in AEM Assets, the enterprise-grade digital asset management solution.
Automatic synchronization: Product images automatically sync when assets are approved or updated in AEM Assets.
Dynamic Media delivery: Leverage Dynamic Media with OpenAPI capabilities for optimized image delivery.
Catalog layers: Product images are applied as a catalog layer, allowing you to overlay AEM Assets imagery on your base catalog.

How it works

The integration has two independent event flows. Both use Adobe I/O Events to transfer events to the Assets integration service, but each direction uses its own event provider:

From AEM Assets to the Assets integration service: When an asset is approved, rejected, or removed, the event is delivered to the Assets integration service. The service matches assets to products using a match-by-SKU or a custom matcher strategy, then sends the product-asset mappings to Commerce Optimizer, where they are stored as product layers.
From Commerce Optimizer to the Assets Integration Service: When a product is updated in Commerce Optimizer, the event is delivered to the Assets Integration Service. The service syncs any matching asset mappings back to Commerce Optimizer.

The updated images are available through storefront APIs (Catalog Service, Live Search, Product Recommendations).

Source and layer configuration

Images from AEM Assets are ingested as a catalog layer with the following source configuration:

Example of a source configuration

{
  "source": {
    "locale": "en-US",
    "layer": "AEM-Assets"
  }
}

This configuration ensures that AEM Assets images are applied as an overlay on your base product catalog.

Prerequisites

Before enabling Product Visuals, ensure you meet the prerequisites for Commerce Optimizer.

Setup

To enable the integration, create a support ticket with your Commerce Optimizer and AEM Assets details. Adobe Support configures the integration and registers your tenant with the Assets Integration Service.

See Configure AEM Assets for Commerce Optimizer for onboarding information.

Configure AEM Assets metadata

To enable automatic product matching, configure your assets in AEM Assets with Commerce metadata.

See Configure AEM Assets for the required metadata fields and steps.

Limitations

Before using Product Visuals, review the integration limitations — the layer-related constraints that affect how AEM Assets data merges with your base catalog.

For capacity and usage allocations (asset storage, Dynamic Media operations, user licenses), see Product Visuals limits in the Boundaries and Limits guide.

Using Product Visuals

After the integration is configured, manage your product images through AEM Assets.

Add images to products

Upload images to your AEM Assets repository.
Add Commerce metadata to the asset.

See Default automatic matching and Custom automatic matching.
Approve the asset for delivery. The asset must be in approved status to trigger synchronization.
The image automatically syncs to Commerce Optimizer.

Apply the AEM-Assets layer

To display AEM Assets images on your storefront, assign the AEM-Assets layer to your catalog view.

More like this

recommendation-more-help

commerce-help-optimizer