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.

August 2025 suite

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.

Breaking changes

Breaking changes

This release introduces the following breaking changes:

• Product Discovery 2.0: The Product Discovery drop-in has been upgraded to version 2.0.0 with a new event-driven architecture. This major version includes breaking changes to the API structure, event handling, and component interfaces. Existing implementations will need to be updated to use the new architecture and updated container interfaces.

Highlights

This release introduces several significant enhancements across the Commerce Storefront ecosystem:

• Cart undo functionality: Added the ability for customers to undo product removals from their cart, providing a safety net for accidental deletions and improving the overall shopping experience.
• Multi-step checkout template: Introduced a comprehensive multi-step checkout template that provides a structured, user-friendly checkout flow with improved navigation and form organization.
• Configurable product editing in cart: Enhanced the cart experience by allowing customers to modify configurable product options directly from the cart without needing to return to the product page.
• Product Listing Page error handling: Resolved critical error display issues in Adobe Commerce Cloud Service (ACCS) Product Listing Pages, ensuring smooth browsing experiences.
• Global locale support for Price component: Enhanced the Price component to respect developer-supplied locale props, enabling consistent currency formatting across different regions.
• Product Discovery 2.0: Major version upgrade featuring a completely redesigned event-driven architecture with enhanced performance, improved documentation with new diagrams, and refactored styling system for better customization capabilities.

Updated boilerplate

The Commerce boilerplate has been significantly enhanced with comprehensive improvements across multiple areas:

• New components: Added carousel and cards-list components for enhanced product display capabilities
• Commerce Storefront compatibility: Improved integration and compatibility with storefront-builder tools
• Architecture improvements: Comprehensive refactoring for better code organization and maintainability
• Scripts.js refactoring: Major restructuring for improved maintainability and performance
• Enhanced drop-in functionality: Improvements across Cart, Checkout, and Wishlist components
• Header optimization: Optimized header performance for faster loading
• Accessibility enhancements: Improved accessibility with global placeholders and modal localization
• reCAPTCHA enhancements: Enhanced reCAPTCHA integration and functionality
• Product Discovery fixes: Resolved search functionality issues
• Documentation improvements: Comprehensive updates to code documentation
• Architecture cleanup: Removed deprecated widgets for cleaner implementation

For complete details, see the Boilerplate Updates changelog entry.

Updated Drop-in SDK

The Drop-in SDK has been updated to include several new features and improvements:

• Global locale support for Price component: Enhanced the Price component to respect developer-supplied locale props, enabling consistent currency formatting across different regions.
• Improved ProductItemCard skeleton styling: Refactored ProductItemCard styles and skeleton component for better visual consistency. Updated skeleton image height, standardized SkeletonRow element sizing, and enhanced visual separation with improved border styling for a cleaner loading experience.
• Enhanced Event Bus functionality: Expanded Event Bus with comprehensive documentation, scoped events for namespaced event handling, and eager loading for immediate payload retrieval. Added support for optional scope parameters in event emission and subscription methods, with comprehensive test coverage for improved event-driven architecture flexibility.
• Icon component URL support: Extended the Icon component to load custom SVG icons from URLs, enabling merchants to use custom payment method icons and other branded elements. The component now supports lazy loading of external SVGs with proper validation, accessibility enhancements, dynamic sizing, and error handling for failed URL requests.

Updated drop-in components

Component	Improvements
Cart v1.5.0	• Extended Add/Update Cart API with custom fields support • Added undo functionality for removed cart items • Enhanced mini cart flexibility with improved slot architecture • Fixed missing Channel Field in AEP events
Checkout v2.0.1	• Updated multi-step checkout tutorial with comprehensive examples • Enhanced modular architecture with event-driven step coordination • Improved support for guest users, logged-in customers, and mixed cart scenarios • Miscellaneous bug fixes and enhancements
Order v1.3.0	• Fixed cancelled product display and messaging issues • Added Channel Field to all AEP events for complete data collection • Resolved reCAPTCHA v3 integration blocking order placement • Enhanced CartSummaryItem user experience for cancelled orders
Personalization v1.0.1	• Fixed personalization data update after order placement • Ensured accurate customer segmentation and targeting post-purchase
Product details page v1.3.0	• Fixed AEM Assets image zoom functionality • Enhanced Product Gallery with video media support • Fixed missing price handling to prevent page crashes • Resolved carousel loopable configuration display issues
Product discovery v2.0.0	• Major version upgrade with completely redesigned event-driven architecture • Enhanced performance and improved container interfaces • Updated documentation with comprehensive new diagrams • Refactored styling system with new CSS files for better customization • Breaking changes require updates to existing implementations
Product recommendations v1.1.0	• Added recommendation API events for better tracking and monitoring • Enhanced screen reader accessibility with improved ARIA labels • Added GraphQL extensibility with customizable fragments and transformers • Fixed recommendation click tracking and added add-to-cart event support
User account v1.0.9	• Fixed empty order list issue when orders contain out-of-stock products • Added grandTotalExclTax field support for accurate tax calculations • Enhanced Order confirmation to prevent negative tax totals on zero-total orders • Improved frontend calculation accuracy by using backend-provided tax data
User authentication v2.1.0	• Fixed missing Channel Field in all AEP events for complete data collection • Enhanced Reset Password form with proper email validation • Prevented unnecessary GraphQL requests for invalid email addresses • Improved event categorization with proper global storefront context
Wishlist	• Fixed accessibility issues with proper aria-label attributes • Enhanced Wishlist functionality with better support for Adobe Commerce as a Cloud Service and move-to-cart flows • Added image slots for customizable image rendering • Fixed alert messaging to show accurate success/error status

Note

To see details for each drop-in component by version, go to the changelog.

Known issues

The known issues for this release suite are:

• Product Recommendations: Configurable products in the Product Recommendations container display $0.00 instead of the expected “As low as $X.XX” minimum price format, even though the GraphQL API returns the correct pricing data.
• Product Recommendations: The rec-click event incorrectly triggers when shoppers click on the wishlist symbol within recommendation product item cards, when it should only generate for actual product clicks.

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.

Commerce Foundation:

Adobe Commerce	Storefront Compatibility Package
2.4.7	4.7.10
2.4.8	4.8.7

Drop-in SDK package updates:

• @dropins/tools@~1.4.0
• @dropins/build-tools@~1.0.1

Drop-in package updates:

• @dropins/storefront-account@~1.0.9
• @dropins/storefront-auth@~2.1.0
• @dropins/storefront-cart@~1.5.0
• @dropins/storefront-checkout@~2.0.1
• @dropins/storefront-order@~1.3.0
• @dropins/storefront-payment-services@~1.0.1
• @dropins/storefront-pdp@~1.3.0
• @dropins/storefront-recommendations@~1.1.0
• @dropins/storefront-wishlist@~2.0.0
• @dropins/storefront-personalization@~1.0.1
• @dropins/storefront-product-discovery@~2.0.0

June 2025 suite

Click to view details

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.

Note

To see details for each drop-in component by version, go to the changelog.

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.

Commerce Foundation:

Adobe Commerce	Storefront Compatibility Package
2.4.7	4.7.9
2.4.8	4.8.6

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.