Releases

Release information

Adobe organizes storefront application releases into logical suite versions and follows a regular release schedule (approximately every other month). Adobe may release updates more frequently to deliver new features or address critical issues.

Release suites

The following sections provide high-level summaries of each release suite and details about the compatibility between storefront components. To see more details about each drop-in component by version, go to the changelog.

June 2025 suite

This release suite introduces four new drop-in components (Product Discovery, Product Recommendations, Wishlist, and Personalization) along with major improvements to existing components including enhanced cart functionality, multi-step checkout, and upgraded infrastructure with Helix 5.

New drop-in components

This suite release includes several new drop-in components to help you build a more personalized and engaging storefront.

Product Discovery: Provides a variety of fully-customizable controls to showcase your products (according to your brand’s aesthetics) and build interactive experiences that engage customers.
Product Recommendations: Provides a powerful way to suggest products to customers based on their browsing patterns and behaviors
Wishlist: Provides both guests and registered customers with a mechanism to store products they are interested in purchasing later.
Personalization: Provides a set of tools and containers designed to display content conditionally, based on Adobe Commerce customer groups, segments, and cart price rules.

Additional improvements

This suite release delivers significant enhancements to existing drop-in components, providing improved functionality and better user experiences for your storefront. The following table lists notable highlights. To see more details about each drop-in component by version, go to the changelog.

Component	Improvements
AEM Assets	Integrated across the suite of drop-in components
Cart	• Improved extensibility for mini cart including additional layout options • Introduced the ability to edit product options directly from the cart • Mini cart shows a message upon adding products to the cart
Checkout	• Configure terms and conditions • Improved error handling • Improved event handling
PDP	• Supports updating cart items by URL (`itemUid`)
Storefront Compatibility Package (SCP)	• Secure personalization features • Social login integration APIs
Boilerplate	• Upgraded boilerplate to Helix 5 • Improvements to scaffolding tool • Centralized configuration through NPM • Updated the localization approach across the boilerplate • Eliminated the need to manage or modify configuration logic manually. Updates can now be delivered through standard package upgrades.

Component compatibility

This section provides details about the compatibility between Commerce Storefront components for this release suite. Adobe has tested and verified that each component version works together.

Click to view details

Commerce Foundation:

Adobe Commerce	Storefront Compatibility Package
`2.4.7`	`4.7.5`
`2.4.8`	`4.8.3`

Drop-in SDK:

@dropins/tools@1.3.0
@dropins/build-tools@1.0.1

Drop-in components:

@dropins/storefront-account@~1.0.7
@dropins/storefront-auth@~2.0.3
@dropins/storefront-cart@1.4.0
@dropins/storefront-checkout@~2.0.0
@dropins/storefront-order@~1.2.0
@dropins/storefront-payment-services@~1.0.1
@dropins/storefront-pdp@1.2.0
@dropins/storefront-recommendations@^1.0.0
@dropins/storefront-wishlist@^1.0.0
@dropins/storefront-personalization@~1.0.0
@dropins/storefront-product-discovery@^1.0.1

April 2025 suite

Click to view details

Commerce Foundation:

Adobe Commerce: 2.4.7
Storefront Compatibility Package: 4.7.1

Drop-in SDK:

@dropins/tools@0.42.0
@dropins/build-tools@0.2.0

Drop-in components:

@dropins/storefront-cart@1.2.2
@dropins/storefront-checkout@1.3.0
@dropins/storefront-order@1.0.5
@dropins/storefront-payment-services@1.0.1
@dropins/storefront-pdp@1.0.0
@dropins/storefront-user-account@1.0.4
@dropins/storefront-user-auth@1.0.6

December 2024 suite

Click to view details

Commerce Foundation:

Adobe Commerce: 2.4.7
Storefront Compatibility Package: 4.7.0

Drop-in SDK:

@dropins/tools@0.38.0
@dropins/build-tools@0.1.1

Drop-in components:

@dropins/storefront-cart@1.0.1
@dropins/storefront-checkout@1.0.0
@dropins/storefront-order@1.0.0
@dropins/storefront-payment-services@1.0.1
@dropins/storefront-pdp@1.0.0
@dropins/storefront-user-account@1.0.0
@dropins/storefront-user-auth@1.0.0

Code changes

Every release includes changes to one or more codebases described in the compatibility section of each release suite. The scope of the change determines whether the MAJOR, MINOR, or PATCH number increases in the application’s version according to semantic versioning:

Given a version number MAJOR.MINOR.PATCH, increment the:
MAJOR version when you make incompatible API changes
MINOR version when you add functionality in a backward-compatible manner
PATCH version when you make backward-compatible bug fixes

Public API

To determine when we increment the MAJOR version we must define a public API. The public API for drop-in components includes the following:

Integration APIs

Integration APIs are functions that are exposed to the storefront application to integrate the drop-in components. These functions are defined in the drop-in SDK and are used by the drop-in components.

File	Function Signatures
`@dropins/tools/fetch-graphql.js`	`setEndpoint` `setFetchGraphQlHeader` `removeFetchGraphQlHeader` `setFetchGraphQlHeaders` `fetchGraphQl` `getConfig`
`@dropins/tools/event-bus.js`	`on` `emit` `lastPayload`
`@dropins/tools/initializer.js`	`mountImmediately`
`@dropins/tools/lib.js`	`debounce` `getFormValues` `getFormErrors` `classes` `deepmerge` `merge` `generateSrcset`

Slots

Slots are built-in extension points in the drop-in components to add your own UI components and functions. The following table lists the default properties and individual drop-in slots that are available:

Type	Description
Default properties available to all slots:	Function signatures of the following functions: `prependSibling` `prependChild` `replaceWith` `appendChild` `appendSibling` `getSlotElement` `onChange`
	Structure of the `dictionary` object
Individual drop-in slots	Function signatures as defined elsewhere on this site (for example, cart slots)

Drop-in design tokens

Drop-in design tokens are defined in the drop-in SDK and are used by the drop-in components to style the storefront application.