Release notes
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.
October 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.
Highlights
This release introduces several significant enhancements across the Commerce Storefront ecosystem:
- Gift card product support: You can now sell gift cards with full functionality including sender/recipient information, custom messages, preset and custom amounts, plus validation rules with complete internationalization support.
- Tiered pricing with quantity discounts: The Cart drop-in automatically applies tiered pricing, showing quantity-based discount percentages and encouraging bulk purchases with clear savings visibility.
- Better search and filtering: Product Discovery now supports new filter operators (contains, startsWith, eq) for more flexible product filtering and precise search results.
- Smoother checkout experience: The Checkout drop-in includes reusable utility libraries, better handling of fully discounted orders, and AEM Assets integration for gift options with visual swatch support.
- Bundle products everywhere: Both Wishlist and Product Details Page drop-ins now handle bundle products, letting customers save and manage complex bundle configurations with full option preservation.
- Address validation available: The User Account drop-in can now validate and suggest corrections for shipping/billing addresses, improving delivery accuracy and reducing failed deliveries.
- Cookie security upgrade: Authentication cookies now use the Secure flag, ensuring they’re only transmitted over HTTPS connections for better security and protection against man-in-the-middle attacks.
Updated boilerplate
The Commerce boilerplate has been enhanced with important bug fixes and improvements:
- AEM Assets compatibility: Decimal dimensions now render properly, supporting image rendering with decimal width/height values (#767).
- Commerce Block documentation: Commerce blocks now include comprehensive README files for better developer onboarding and implementation guidance (#728).
- Configuration error handling: Missing or invalid site configurations now show a helpful 418 error page that provides clear guidance to developers (#714).
- Configuration fallback enhancement: Single-endpoint setups now automatically fall back to “commerce-endpoint”, simplifying configuration (#700).
- Metadata and schema improvements: Lowercase product SKUs now work in URLs, and metadata handling works properly for multistore configurations with JSON-LD path resolution (#406, #686).
- Mini-PDP component reorganization: The mini-pdp component now lives in the components folder for better code organization and reusability (#722).
- PDP state management: Multiple PDPs on the same page no longer overwrite each other’s state, ensuring proper product data isolation (#696).
- Placeholder data preservation: Placeholder data no longer gets lost, preventing content display issues (#689).
- Search functionality improvements: Search functionality now handles results better with improved styling (#776).
- UI accessibility improvements: Non-interactive elements no longer show pointer cursors, improving accessibility compliance (#681).
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:
- New Table component: The new Table component includes sortable columns, mobile-responsive layouts (stacked/scrollable), expandable row details, loading states with skeleton UI, and flexible column configuration with accessibility support (#116, #128).
- New MultiSelect component: The new multi-select dropdown includes search/filter functionality, keyboard navigation (arrow keys, Enter, Escape), select/deselect all controls, customizable theming, floating label support, and comprehensive accessibility (ARIA labels, screen reader announcements) (#126).
- New InputFile component: The new file upload component includes custom styling, icon support, accept attribute for file type restrictions, and multiple file selection support (#92).
- Button component enhancements: Button components now support href and type properties (submit/reset/button), enabling better link functionality and form integration with proper semantic HTML output (#121).
- ToggleButton improvements: ToggleButton components now support disabled states with proper styling and improved accessibility attributes (#120).
- Incrementer component enhancements: Incrementer components now support a showButtons prop to conditionally hide increase/decrease buttons while maintaining input functionality and keyboard accessibility (#112).
- GraphQL validation tools: The GraphQL validation CLI now supports excluded paths option (-x flag) for more flexible development workflows (#96).
- API method additions: The fetch-graphql package now includes the getFetchGraphQlHeader method for header inspection, and the AEM Configs API now supports a match function option for improved configuration flexibility (#113, #105).
- Slot API enhancements: The Slot API now includes a remove method for slot element removal, providing developers with granular control over slot lifecycle management (#88).
- Lazy slots functionality: Slot components now support a lazy prop for performance optimizations by deferring slot rendering until needed and reducing initial page load times (#107).
- Image loading optimization: Slot initialization now prevents intelligent image loading, stopping premature network requests and improving performance (#123).
- Cross-platform compatibility: Compilation now works properly on Windows systems, ensuring consistent development experience across all operating systems (#108).
Updated drop-in components
| Component | Improvements |
|---|---|
| Cart v1.5.1 | • Tiered pricing now applies quantity-based discounts automatically • Configurable product merging logic now creates cleaner cart experiences • Company context synchronization works for B2B scenarios • Cross-tab logout synchronization now works properly • Checkout tax display shows “TBD” until taxes are calculated • Quantity input validation now handles maximum values correctly • Accessibility and Lighthouse scores are now higher |
| Checkout v2.1.0 | • Checkout architecture now includes reusable utilities and fragment-based layouts • Zero payment methods now work properly for fully discounted orders • Gift options now integrate with AEM Assets image support |
| Order v1.4.0 | • Order placement response structure now uses shared fragment pattern • Personal email context now appears in ACDL events • ACDL order context now includes payment and discount tracking • Returns list pagination now has smarter scroll behavior • GraphQL schema configuration now supports multi-store setups |
| Payment services v1.0.2 | • Package dependencies now use public npm registry with @adobe-commerce scope • PayPal Fastlane payment method now supports accelerated checkout • Guest cart creation now handles errors better • Local development base URL configuration has been updated |
| Product details page v1.3.5 | • Gift card products now work with sender/recipient information, custom messages, amount selection, and validation rules • Global locale integration now supports multi-language setups • Swatch accessibility now uses unique IDs and aria-labels • Dynamic bundle pricing calculations now work correctly • GraphQL integration upgraded to v1.2.0 with better header management • Carousel keyboard navigation now respects native browser behavior |
| Product discovery v2.1.0 | • getFetchGraphQlHeader method now available for header inspection • Search filters now support contains, startsWith, and eq operators • Facet checkboxes now use unique IDs for better accessibility |
| Product recommendations v1.1.1 | • ProductList now shows price ranges for complex products • Mobile view now has better carousel scrolling and responsive layouts • Global CSS styling conflicts are now resolved to prevent style leakage |
| User account v1.2.0 | • Address validation now available with new component and container • Form submission control now includes onSubmit callback prop • UID support now works for address selection and identification • Order history data structure now includes sku and urlKey fields • Example implementations now show address validation patterns |
| User authentication v2.1.1 | • Cookie security now uses Secure flag for HTTPS-only transmission |
| Wishlist v2.0.1 | • Visual flickering when opening wishlist is now resolved • Bundle product support is now available • API is now cleaner with unused pagination parameters removed |
Known issues
There are no known issues for this release suite.
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.11 |
2.4.8 | 4.8.8 |
Drop-in SDK package updates:
@dropins/tools@~1.5.0@dropins/build-tools@~1.0.1
Drop-in package updates:
@dropins/storefront-account@~1.2.0@dropins/storefront-auth@~2.1.1@dropins/storefront-cart@~1.5.1@dropins/storefront-checkout@~2.1.0@dropins/storefront-order@~1.4.0@dropins/storefront-payment-services@~1.0.2@dropins/storefront-pdp@~1.3.5@dropins/storefront-recommendations@~1.1.1@dropins/storefront-wishlist@~2.0.1@dropins/storefront-personalization@~1.0.1@dropins/storefront-product-discovery@~2.1.0
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
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 |
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-clickevent 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.11 |
2.4.8 | 4.8.8 |
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. |
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 | setEndpointsetFetchGraphQlHeaderremoveFetchGraphQlHeadersetFetchGraphQlHeadersfetchGraphQlgetConfig |
@dropins/tools/event-bus.js | onemitlastPayload |
@dropins/tools/initializer.js | mountImmediately |
@dropins/tools/lib.js | debouncegetFormValuesgetFormErrorsclassesdeepmergemergegenerateSrcset |
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:prependSiblingprependChildreplaceWithappendChildappendSiblinggetSlotElementonChange |
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.