AEM Assets Integration release notes

These release notes describe all releases for the AEM Assets Integration and include:

New features
Fixes and improvements
Known issues

For feature changes and fixes released outside of the regular feature release version, review the Hosted service updates sections.

Learn more about upcoming releases, product support, and which Adobe Commerce versions support the AEM Assets Integration extension, see the Adobe Commerce Release schedule and Product Availability topics.

Hosted service updates

These release notes describe feature changes and fixes that occurred and were released outside of the regular feature releases for the hosted service.

v1.4.9

October 7, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Fixed an intermittent issue where creating a category in the Admin displayed a Deprecated Functionality error because null was used as an array offset. Now, the New Category form loads without the deprecation notice, and categories can be created successfully.

v1.4.8

October 5, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Fixed an issue where category images from AEM Assets were not exported to the catalog or returned in GraphQL responses when AEM Assets was the Visualization Owner. To export the image, reassign the AEM asset to the category after applying the fix.

v1.4.7

September 18, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Fixed an issue where saving the AEM Assets Integration configuration, including its workspace.json upload, with the Commerce Async Config Save (introduced in Adobe Commerce 2.4.7) enabled, failed to register or update the tenant with ARES. The configuration appeared to save successfully, but the App Builder OAuth values remained unchanged. Uploaded credentials are now processed correctly by the asynchronous consumer.

v1.4.6

September 8, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Custom AEM image roles are now retained during synchronization. Custom values in the AEM commerce:roles metadata field are ingested and mapped to Commerce product media-gallery data, in addition to the four standard roles (image, small_image, thumbnail, and swatch_image). For details, see Custom automatic matching.

Adobe Commerce can now check for AEM Assets Integration extension updates asynchronously and notify administrators in the Admin when a new version is available. Administrators can also run a manual check using bin/magento aem:assets:check-update. For details, see Check for extension updates.

v1.4.5

August 3, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Fixed a backward-compatibility issue with store-view asset visibility. Existing asset synchronization requests that don’t specify hidden store views continue to work without changes.

v1.4.4

July 30, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Now, merchants can hide specific store views for an AEM asset. When AEM Assets marks an image as hidden for one or more store views, Commerce excludes that image from the storefront on those store views. The Admin product media gallery now includes a Store View Visibility field that shows which store views hide the image.

Fixed an issue where the Page Builder integration package incorrectly required the magento/module-page-builder package, preventing the package from being installed independently.

v1.4.2

July 10, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Fixed an issue where asset role attributes (image, small image, thumbnail, and swatch image) could accumulate empty store-view-level values, causing images to appear missing on non-default store views. Now, these attributes are global in scope, and existing empty store-view rows are removed so that images inherit correctly from the default store view.

v1.4.1

June 15, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Fixed an issue where the OBSERVABILITY section header was missing from the Admin System menu when the AEM Assets integration was enabled, leaving the Subscription List link displayed without its heading.

Fixed an issue where saving the AEM Assets integration configuration displayed a raw PHP warning instead of a clear message on instances where Dynamic Media Open API is not enabled. A clear, generic error message now appears.

v1.4.0

June 12, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Improved overall stability and events processing performance through batched asset update calls.

v1.3.7

June 2, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

The Commerce Admin includes an asset-centric Sync Status list to search, filter, sort, and review synchronized AEM Assets by asset attributes instead of product associations. See View AEM Assets sync status.

v1.3.6

May 14, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

When images or assets are imported from AEM into a Commerce product media gallery, alt text is now carried over as part of the sync. Alt text can be set per store view in AEM Assets. See Localized alt text in AEM Assets metadata.

v1.3.5

April 1, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Fixed an issue where duplicate sets of product image roles appeared in the Admin for configurable products.

Fixed an issue in UpdateAssetImageRolesDataPatch that caused an integrity constraint violation during upgrades or data patches.

v1.3.4

March 11, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Added support for Adobe Commerce 2.4.9-beta1 and PHP 8.5.

The Program ID, Environment ID, and Domain mapping fields now auto-populate as dropdowns based on the user’s IMS session.

v1.2.14

February 13, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Fixed a custom matcher issue where the runtime actions dropdown showed unsaved workspace data after page reload.

v1.2.13

February 10, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Added an Adobe I/O Workspace Configuration field that simplifies the custom matching setup. Merchants can now upload their App Builder workspace.json file to automatically populate OAuth credentials and runtime action endpoints.

v1.2.12

January 29, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Fixed an issue where stale no_selection values in custom attributes for asset roles were not removed during asset sync, causing some images to not display correctly in Edge Delivery Services.

v1.2.11

January 15, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Improved the product edit page by hiding file size and dimensions for AEM assets since they are dynamically optimized by CDN. Now, pages prerender correctly when the AEM Assets integration is enabled.

v1.2.10

January 12, 2026

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Fixed an issue where product custom attributes could not be updated via REST API when the product had an image and the AEM Assets integration was enabled. Now, product custom attributes update correctly via REST API.

Fixed an issue where hidden product images were not displayed as hidden in the Admin UI on the product edit page. Now, image visibility status displays correctly.

Fixed an issue where product images from AEM Assets were not synchronized to Adobe Commerce due to a deserialization error. Now, all image attributes (image, small_image, and swatch_image) synchronize correctly.

v1.2.7

November 6, 2025

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Fixed an issue where product thumbnail images were displayed inconsistently after enabling the AEM Assets integration on the Mini Cart, Cart, and Checkout pages. Now, product images render consistently across all pages, even after refreshing the page.

v1.2.6

October 24, 2025

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Resolved an issue where consecutive bulk product update requests could leave the status tracking flag stuck preventing subsequent updates from processing correctly. Now, status is reset even if an error occurs.

v1.2.5

October 22, 2025

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Fixed an issue where updating the position of an existing image mapping in the Adobe Commerce Admin resulted in a PHP type error.

v1.2.4

October 17, 2025

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Improved overall stability of custom attributes. Custom attributes now update correctly when using asynchronous APIs.

Now, the product-asset synchronization does not fail when a base link URL is defined.

v1.2.3

October 2, 2025

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Fixed an issue with updating product attributes. Product attributes now update as expected, and an appropriate error is returned instead of a 200 response when updates fail.

v1.2.2

September 18, 2025

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Improved overall image stability on mini cart, cart, and checkout pages. Images on these pages now load properly.

v1.2.0

August 7, 2025

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Now, merchants can choose the source for image and media assets by selecting a Visualization Owner when configuring the Assets integration from the Admin.

Updated the custom automatic matching endpoints with a new asset_matches attribute. This change allows you to implement your own matching logic to return all assets associated with a specific productSku.

v1.1.2

June 11, 2025

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Added support for Adobe Commerce 2.4.8 and PHP 8.4.

v1.1.0

April 23, 2025

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Now, a Custom Domain URL can be used instead of the AEM Delivery URL. If a merchant sets a Custom Domain Name in their AEM dashboard, it is necessary to add this Custom Domain URL in Commerce.

Improved overall logs for AEM Assets synchronization processes.

v1.0.22

March 12, 2025

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

Now, the Assets selector IMS Client ID is required by the Assets Selector to enable mapping AEM Assets images with product categories and Page Builder generated content.

v1.0.20

February 11, 2025

[Supported]{class="badge informative" title="Supported"} Adobe Commerce version 2.4.5 and later releases.

General availability release.