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

Links to the StorefrontSDK repository do not resolve unless you have access to that 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.10
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