Changelog

Product Recommendations changelog

July 30, 2026

Product Recommendations — no user-facing changes

This suite does not add user-facing Product Recommendations changes beyond the pinned version.

June 10, 2026

New features

currentProduct prop on ProductList: The ProductList container now accepts a currentProduct prop ({ sku, price }) that the storefront reads from the ACDL productContext.pricing event. When provided, the drop-in uses the GetRecommendationsByUnitIdsWithCurrentProduct GraphQL query so recommendation units update automatically on variant selection without a page reload. Falls back to the base query when the prop is absent for full backward compatibility. The standalone currentSku prop is deprecated — use currentProduct.sku instead (#37, #1244).
inStock flag in item context: The inStock field is now included in PRODUCTS_VIEW_FRAGMENT and the Item interface, letting integrators read ctx.item.inStock from slot context to disable or hide Add to Cart for out-of-stock recommended products (#38).

Infrastructure

Node.js 22 LTS: The package now builds and distributes using Node.js 22 LTS. The engines.node constraint has been removed as this drop-in targets browser environments exclusively.

April 30, 2026

Major version upgrade. The Product Recommendations drop-in has been updated to the following changes:

Catalog view support: The drop-in now uses the recommendationsByUnitIds GraphQL query instead of the legacy getRecommendations query. This ensures recommendation units respect catalog view scoping, so globally scoped units work correctly in multi-catalog and multi-store setups. The previous getRecommendations query did not honor catalog view context, causing recommendation units to appear blank for stores using non-default catalog views (#34).
Corrupted view history recovery: Resolved a reliability issue where a corrupted userViewHistory value in browser local storage could permanently prevent recommendations from loading on the product page. Because local storage is never automatically cleared, a single corrupted entry would break recommendations indefinitely for affected shoppers until they manually cleared their storage (#34).
Title rendering fix: Resolved an issue with recommendation unit title display (#36).

February 17, 2026

The Product Recommendations drop-in has been updated with the following changes:

Drop-in SDK upgrade - Updated to Drop-in SDK ~1.7.0. No user-facing changes in this release.

January 8, 2026

Major version upgrade for suite alignment. The Product Recommendations drop-in has been updated to include the following changes:

Revised Adobe Commerce Drop-in License Agreement - Updated license agreement to current terms. Drop-ins are now exclusively licensed for Adobe Commerce as a Cloud Service (ACCS) and Adobe Commerce Optimizer (ACO). Use on on-premise or Platform-as-a-Service (PaaS) deployments is not permitted under the license agreement (#33).

October 14, 2025

The Product Recommendations drop-in has been updated to include the following changes:

Complex products show price ranges: The ProductList container now properly displays price ranges for configurable, grouped, and bundled products using the PriceRange component, while simple products continue showing standard pricing. This includes proper type checking and comprehensive test coverage ( #29 ).
Mobile experience improvements: Mobile view now has better carousel scrolling, proper viewport-based card sizing (80vw with 300px max-width), and automatic left margin adjustment for edge-to-edge scrolling on smaller screens ( #20 ).
CSS conflict resolution: Global CSS selector conflicts are now resolved by renaming .recommendations-product-list__content to .recommendations-carousel__content, preventing unintended style leakage and ensuring proper component encapsulation ( #32 ).

August 12, 2025

The Product Recommendations drop-in has been updated to include the following changes:

Added recommendation API events: Introduced new events recs-api-request-sent and recs-api-response-received to provide better tracking and monitoring of recommendation API interactions.
Added recommendation add-to-cart event: Implemented recs-add-to-cart-click event that triggers when shoppers click the “Add to cart” button on simple products within recommendation containers, including productId and unitId in the event payload.
Enhanced screen reader accessibility: Improved Product Recommendations accessibility by adding <section> tags with aria-label="product recommendations" for carousel boundaries and role="group" with numbered aria-label attributes (e.g., “product 1 of 8”) for individual product slides, enabling better navigation for screen reader users.
Added GraphQL extensibility: Enhanced the Recommendations drop-in with extensible GraphQL fragments and data module transformers, enabling developers to customize and extend API responses according to their specific requirements.
Fixed recommendation click tracking: Resolved an issue where the rec-click event was not triggering when clicking products in recommendation units.

June 25, 2025

Initial release of the Product Recommendations drop-in component, including accompanying developer and merchant documentation.