Release Notes

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.

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 as a Cloud Service 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