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.

January 2026 suite

This suite release delivers several enhancements to the Drop-in SDK and drop-in components. The following sections provide details about the improvements. To see more details about each drop-in component by version, go to the changelog.

Breaking changes

This release introduces the following breaking changes:

• Major version 3.0.0 for all B2C and B2B drop-in components. All drop-ins are now exclusively licensed for Adobe Commerce as a Cloud Service (ACCS) and Adobe Commerce Optimizer (ACO). Use of drop-ins on on-premise or Platform-as-a-Service (PaaS) deployments is not permitted under the license agreement.
• Checkout drop-in: Billing address now uses customerAddressUid field instead of previous address field structure. Update any code that reads or sets billing address data.
• Checkout and Cart drop-ins: Event handling now includes a type property. Events checkout/initialized and checkout/updated now include type: 'cart' | 'quote', and Cart only processes events where type is 'cart' (or undefined for backward compatibility). Update event listeners if you filter or process these events.
• Order drop-in: GraphQL mutation changed from placeNegotiableQuoteOrder to placeNegotiableQuoteOrderV2. Update any custom order placement code that uses this mutation.
• User Account drop-in: GraphQL query structure changed for order items. Fields product_sku and product_url_key are now at the order item level instead of nested under product. Update any code that parses order history data.
• Boilerplate: Authentication flow refactored to use page reloads instead of in-place updates. If you have custom authentication integrations, test thoroughly to ensure compatibility with the new flow.

Highlights

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

• Major version 3.0.0 for all drop-ins: All drop-in components have been upgraded to version 3.0.0 and are now exclusively licensed for Adobe Commerce as a Cloud Service (ACCS) and Adobe Commerce Optimizer (ACO). Use of drop-ins on on-premise or Platform-as-a-Service (PaaS) deployments is not permitted under the license agreement. Ensure your Commerce instance is running on ACCS or ACO before upgrading.
• B2B commerce expansion: Complete B2B checkout support with Payment on Account, Purchase Order payment methods, company credit integration with limit validation, and quote-specific checkout flows. Company context switching automatically refreshes order data when B2B users switch between companies.
• New B2B drop-in components: Five new B2B-specific drop-ins enable enterprise commerce workflows including Company Management for organizational structure and permissions, Company Switcher for multi-company scenarios, Purchase Order for procurement workflows, Quote Management for negotiable quotes and templates, and Requisition List for repeat ordering.
• Universal Editor integration: The Adobe Commerce boilerplate now integrates with Universal Editor, enabling content authors to edit and preview storefront content directly within the authoring environment with improved rendering stability.
• Adobe Commerce Optimizer support: New integration enables dynamic pricing based on customer segments and price books, with automatic price book ID fetching for both authenticated and non-authenticated users.
• Enhanced tier pricing: Product Details Page now displays quantity-based discount pricing, helping customers understand bulk purchase savings with clear tier price visibility.
• Permission-based access control: New Customer Role Permissions API enables B2B permission checking with intelligent caching, returning granular permissions for purchase orders, company management, and other B2B capabilities.
• Improved price display: Product Discovery now correctly displays both final (sale) prices and crossed-out regular prices for products with special pricing, ensuring customers see available discounts for both simple and complex products.
• Translation system enhancements: Checkout drop-in implements placeholder-based translation system for easier internationalization, while User Account supports custom language definition overrides for brand-specific terminology.
• Pagination SEO improvements: Drop-in SDK now uses semantic <a> tags with proper hrefs for pagination links, improving search engine crawlability and accessibility across all drop-ins.

Updated boilerplate

The Commerce boilerplate has been enhanced with important updates and improvements:

New features:

• Universal Editor integration: The boilerplate now supports Adobe Universal Editor for in-context content editing, enabling visual authoring experiences directly within the storefront (#866, #891).
• Payment Services v2 upgrade: Payment Services drop-in has been upgraded to version 2 with enhanced payment processing capabilities and improved user experience (#881).
• AEP analytics configuration: Adobe Experience Platform analytics configuration is now integrated, providing better tracking and insights into customer behavior (#969).

Improvements and fixes:

• Authentication flow refactor: Authentication flow now uses page reloads for more reliable state management and better compatibility with server-side rendering (#972).
• Checkout success flow enhancement: Checkout success page now redirects to order details page, providing customers with immediate access to their order information and improving post-purchase experience (#882, #831).
• Configurable product links fix: Product links for configurable products now work correctly, ensuring proper navigation to product detail pages (#994).
• Empty cart checkout prevention: Checkout process now properly prevents access when cart is empty, improving user experience and preventing errors (#1015).
• Wishlist sign-up fix: Sign-up functionality from wishlist now works properly, allowing guest users to create accounts while preserving their wishlist items (#983).
• Create account overlay fix: Account creation overlay now closes properly after successful registration (#934).
• Universal Editor rendering improvements: Block configuration rows now render more safely in Universal Editor and Document Authoring environments (#1030).

B2B integrations:

• Commerce Account Navigation block: New block with GraphQL permission integration for B2B account navigation, dynamically showing menu items based on user permissions (#779, #789, #797).
• Requisition List integration: Integrated requisition list drop-in into PDP and PLP blocks, enabling B2B users to add products to requisition lists (#755, #851, #886, #911).
• Negotiable Quote blocks: Added B2B negotiable quote block and quote template block for managing quotes and quote templates (#778, #884, #890, #916).
• Company Switcher integration: Integrated company switcher for multi-company B2B scenarios with context-aware redirects for orders, purchase orders, and quotes (#701, #914, #982).
• Purchase Order integration: Integrated Purchase Order drop-in with details page and approval workflows (#736, #826, #900, #909).
• Company Management integration: Integrated company profile, users, structure, and roles & permissions management (#726, #745, #816, #838, #926).
• B2B permission system: Enabled customer permission roles in Auth initializer and checkout permissions handling (#871, #880, #887, #888).
• Request quote from cart: Added ability to request negotiable quotes directly from the cart (#731, #970).

Updated Drop-in SDK

Internal Links

The links to the StorefrontSDK repository will not resolve unless you have access to this repository.

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

New features:

• Pagination SEO enhancements: Pagination components now support a routePage prop that generates anchor tags instead of buttons, enabling proper SEO with crawlable page links, native browser link behavior (right-click, open in new tab), and improved accessibility while maintaining all existing functionality (#143).
• Price formatting utility: The new getPriceFormatter utility function enables efficient bulk price formatting operations by creating reusable Intl.NumberFormat instances, reducing overhead when formatting multiple prices, and providing centralized locale resolution with proper fallback hierarchy (prop locale → global locale → environment locale → en-US default) (#129).
• New icons: New icons are now available in the Icon component: Business (company/organization representation), List (list view toggle), Purchase (purchase/buy actions), Quote (quote request actions), Structure (organizational structure), and Team (team/group representation) (#150).

Improvements and fixes:

• Table component improvements: Table components now include enhanced mobile responsiveness with automatic stacked layout via container queries, data labels automatically generated from column headers on mobile, improved styling for row details and expanded states, better typography hierarchy in mobile view, and enhanced visual structure with proper borders and spacing (#149).
• Field component enhancements: Field components now provide more robust child component rendering, improving support for wrapped components and complex field structures (#139).
• Icon stroke width fix: Icon components now properly apply stroke width styles to all nested SVG elements, ensuring consistent visual appearance across all icon types instead of only applying to the root SVG element (#151).
• Multi-store detection fix: Fixed incorrect multi-store detection in repoless EDS setups where configurations with additional non-store keys were incorrectly identified as multi-store, causing Store Switcher to activate unnecessarily and resulting in rendering errors (#156).

Updated drop-in components

Component	Improvements
Cart v3.0.0	• Major version upgrade with improved B2B integration and event handling • Product names with special characters now display correctly • Requisition list integration for B2B workflows • Analytics events now fire correctly (cart open, start checkout) • Revised Adobe Commerce Drop-in License Agreement
Checkout v3.0.0	• Major version upgrade with comprehensive B2B checkout support • Payment on Account and Purchase Order payment methods for B2B transactions • Company credit integration with credit limit validation • Quote-specific checkout flow with dedicated containers and event handling • Placeholder-based translation system for internationalization • Improved empty cart handling and checkout permission validation • Billing address now uses customerAddressUid for better compatibility • Revised Adobe Commerce Drop-in License Agreement
Order v3.0.0	• Major version upgrade with B2B company context support • Automatic order data refresh when switching companies • Enhanced error handling with redirect to orders list when order access is denied • Revised Adobe Commerce Drop-in License Agreement
Payment Services v3.0.0	• Major version upgrade for suite alignment • Revised Adobe Commerce Drop-in License Agreement
Product Details Page v3.0.0	• Major version upgrade with tier pricing support for displaying quantity-based discount pricing • Product attributes now render properly in the product detail view • Revised Adobe Commerce Drop-in License Agreement
Product Discovery v3.0.0	• Major version upgrade with price display and search improvements • Fixed final price display for products with special pricing • Currency code validation with USD fallback for unsupported currencies • Fixed URL parameter handling in search results • Fixed facet checkbox rendering issues • Revised Adobe Commerce Drop-in License Agreement
Product Personalization v3.0.0	• Major version upgrade with SDK and dependency updates • Updated to Elsie SDK 1.6.0 for latest component improvements • Revised Adobe Commerce Drop-in License Agreement
Product Recommendations v3.0.0	• Major version upgrade for suite alignment • Revised Adobe Commerce Drop-in License Agreement
User Account v3.0.0	• Major version upgrade with B2B company context support and translation improvements • Automatic order refresh when switching companies in B2B environments • Translation override support for customizing UI text • Fixed product links for configurable products in order history • Revised Adobe Commerce Drop-in License Agreement
User Auth v3.0.0	• Major version upgrade with B2B role permissions and Adobe Commerce Optimizer support • Customer role permissions API for B2B permission checking • Adobe Commerce Optimizer integration for dynamic pricing • Customer group tracking with dedicated event emission • Improved cookie security for localhost development • Revised Adobe Commerce Drop-in License Agreement
Wishlist v3.0.0	• Major version upgrade with SDK and dependency updates • Updated to Elsie SDK 1.6.0 for latest component improvements • Revised Adobe Commerce Drop-in License Agreement

New B2B drop-in components

This release introduces new B2B-specific drop-in components for enterprise commerce workflows:

Component	Features
Company Management v1.0.0	• Company profile viewing and editing for admins • User and team management with drag-and-drop organization • Roles and permissions management • Company structure CRUD operations • New company creation workflow • Mobile-optimized team management
Company Switcher v1.0.0-beta	• Multi-company context switching for B2B users • Context-aware page reloads for data consistency • Integration with account navigation • Automatic product availability validation on company switch
Purchase Order v1.0.0	• Purchase Order payment method for B2B checkout • Purchase Order details page with approval workflow • Permission-based access control • Company context handling with error management
Quote Management v1.0.0	• Request negotiable quotes from cart • Quote list and template management • Quote-specific checkout flow • File attachments with type restrictions • Quote ownership validation and permissions
Requisition List v1.0.0	• Requisition list management (create, view, edit, delete) • Add products from PDP and PLP • Complex product support with all options • Cart integration for moving items between lists

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.14

Drop-in SDK package updates:

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

Drop-in package updates:

• @dropins/storefront-account@~3.0.0
• @dropins/storefront-auth@~3.0.0
• @dropins/storefront-cart@~3.0.0
• @dropins/storefront-checkout@~3.0.0
• @dropins/storefront-order@~3.0.0
• @dropins/storefront-payment-services@~3.0.0
• @dropins/storefront-pdp@~3.0.0
• @dropins/storefront-personalization@~3.0.0
• @dropins/storefront-product-discovery@~3.0.0
• @dropins/storefront-recommendations@~3.0.0
• @dropins/storefront-wishlist@~3.0.0

B2B Drop-in package updates:

• @dropins/storefront-company-management@~1.0.0
• @dropins/storefront-company-switcher@~1.0.0-beta
• @dropins/storefront-purchase-order@~1.0.0
• @dropins/storefront-quote-management@~1.0.0
• @dropins/storefront-requisition-list@~1.0.0

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.

Breaking changes

This release introduces the following breaking changes:

• Product URL SKU enforcement: The application now generates product URLs with lowercase SKUs only. If your products have uppercase SKUs but your metadata mapping doesn’t properly handle the case conversion, the generated lowercase links may not resolve to your actual products. Before upgrading:
  • Verify your metadata mapping can handle SKU case conversions from uppercase to lowercase in your storefront configuration.
  • Test product links with uppercase SKUs after upgrading to ensure they still resolve to the correct product pages.
  • Note: While you can disable lowercase SKU enforcement, this is not recommended as it goes against URL consistency standards.

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

Internal Links

The links to the StorefrontSDK repository will not resolve unless you have access to this repository.

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	• Added FASTLANE payment method code to PaymentMethodCode enum
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.14

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

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

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.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	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.