Release Notes

Changelog

Filter

July 30, 2026

Boilerplate Updates

Boilerplate

The Commerce boilerplate has been updated with a Drop-in SDK major upgrade, multi-storefront browsing history support, and accessibility fixes across boilerplate blocks:

Infrastructure

Drop-in SDK: @dropins/tools upgraded to 2.0.0, including a TypeScript 6.0 and ESLint 9 upgrade across the SDK. See Updated Drop-in SDK for consumer migration steps and sub-package versions. Jest upgraded to 30.4.2 and Storybook to 10.4.0 (#205).

Fixes and improvements

Drop-in SDK: COMPANY_CREATE added to the default reCAPTCHA form map (#206). Added a TypeScript return type for events.lastPayload (#216). Accessibility fixes:
- Picker no longer leaves Add to Cart disabled after single-option narrowing on configurable PDPs (#219).
- Accessible labels on password validation icons (#220).
- Picker’s accessible name and label association (#233).
- Screen reader announcements for Field and InLineAlert status and error messages (#253).
- Unique accessible names for InLineAlert’s Undo/Dismiss action buttons (#242).
- Modal focus management and dialog semantics (#244).
- ToggleButton’s accessible name (#246) and invalid HTML ids when its value contains spaces (#262).
- Higher-contrast keyboard focus indicators and a date-format fix in InputDate.
Product recommendations: getPurchaseHistory and getProductViewHistory now key browsing history by a storefront identifier, so history no longer mixes between storefronts that share a domain. A SaaS storefront and an Adobe Commerce Optimizer storefront on the same domain are a common example. Prerendered product pages (hovered but never visited) no longer pollute that history either (#1301, #1361).
Recommendations block: Now forwards cart SKUs to the recommendations request, so cart-based recommendation units reflect what’s actually in the shopper’s cart (#1366).
Cart (gift cards): Adding a gift card product from the product listing page no longer fails silently. Gift card products now redirect to the product details page to collect the required sender and recipient information, the same way bundle and configurable products already do (#1328).
Modal: The modal block now emits a close event with the dismissal reason (button, backdrop, or programmatic), so you can react when a modal closes (#1318).
Accessibility: The header sign-in dropdown, mini cart panel, and search popover now stay scrollable and reachable at reduced viewport heights, meeting WCAG 1.4.10 Reflow (#1312, #1315, #1319).
- The My Account button (#1321) and mini cart button (#1337) now announce their expanded state to screen readers.
- The “Updating Cart” button text has higher contrast and now announces its progress to screen readers (#1323, #1327).
- The checkout Edit-cart link, cart Edit button, and product image and Add to Cart links each have distinct accessible names (#1330, #1334, #1340).
- Checkout status messages now use persistent aria-live regions (#1344).
B2B (Checkout): Fixed an issue that could prevent the Credit Card checkout fields from rendering (#1347, B2B).

June 10, 2026

Boilerplate Updates

Boilerplate

The Commerce boilerplate has been updated with Drop-in SDK bundle optimizations, seller-assisted buying blocks, Company Hierarchy (B2B), Requisition List Sharing (B2B), out-of-stock Add to Cart gating, and analytics and performance fixes:

Infrastructure

Drop-in SDK: @dropins/tools upgraded to 1.9.0, including @dropins/build-tools 1.2.0, @adobe-commerce/elsie 1.9.0, @adobe-commerce/event-bus 1.1.0, @adobe-commerce/fetch-graphql 1.3.0, @adobe-commerce/recaptcha 1.2.0, and @adobe-commerce/storefront-design 1.1.0. Lazy icon loading and code consolidation reduce HTTP requests by 29–85% per drop-in. Drop-ins must be rebuilt against this SDK release to benefit from the optimizations (#200).
AEM library: scripts/aem.js updated to 3.1.2 (#1250).

Fixes and improvements

PDP and PLP blocks: The Add to Cart button is now disabled for out-of-stock products on the PDP and PLP using the inStock property exposed by the drop-ins (#1223).
Recommendations block: Add to Cart is disabled for out-of-stock recommended products (#1235). The block also forwards currentProduct context from the ACDL data layer to the Recommendations drop-in, so recommendation results respond reactively to variant selection on the PDP (#1244).
Analytics: Locale is now mapped from demo-config-aco.json in the delayed script for correct event processing in Adobe Commerce Optimizer storefronts (#1238).
Performance: fetchPlaceholders uses force-cache to skip revalidation round-trips after the 2-hour max-age expires, eliminating redundant CDN traffic during navigation (#1273).
Cart block: Removed an unused routeProduct prop from the OrderSummary render call (#1230).
Seller Assisted Buying: New commerce-seller-assisted-buying-activity and commerce-seller-assisted-buying-settings blocks let store administrators place and manage orders on behalf of customers, with an activity log and customer consent settings. A header banner identifies the active assisted-buying session (#1283).
B2B (Company Hierarchy): New commerce-b2b-company-hierarchy block renders the nested team structure using the CompanyHierarchy container from the Company Management drop-in (#1240, B2B).
B2B (Requisition List Sharing): New commerce-b2b-requisition-list-sharing block lets B2B users share requisition lists with colleagues by email or by copying a shareable link (#1268, B2B).
B2B (Authentication): Fixed a bug where the X-Adobe-Company header was sent on guest GraphQL requests due to session storage being restored from local storage on page load (#1248, B2B).

April 30, 2026

Boilerplate Updates

Boilerplate

The Commerce boilerplate has been updated with a Universal Editor image model fix, Drop-in SDK dependency upgrades, the Product Recommendations drop-in upgraded to v4, and B2B additions for Order Comments and Quick Order improvements:

Document Authoring

Image model definition: Universal Editor image model definition and component models updated to fix image handling in the authoring interface (#1159).

Infrastructure

Drop-in SDK: @dropins/tools upgraded from 1.8.0 to 1.8.1, which includes @adobe-commerce/elsie 1.8.1 and @adobe-commerce/recaptcha 1.1.0.

Fixes and improvements

Product Recommendations block: Block updated to use the Recommendations drop-in v4, which switches to the getRecommendationsUnitsByIds GraphQL query for proper catalog view support (#1183).
B2B (Order Comments): New commerce-order-comments block renders order-level comments on B2B order details pages using the OrderComments container from the Order drop-in (#1210, B2B).
B2B (Quick Order): Quick Order block updated with consistent configurable-product Add to Cart handling, extended handleAddToCart callback payload with parentSku and optionsUIDs, and fixed duplicate event emissions on option changes (#1210, B2B).

March 24, 2026

Boilerplate Updates

Boilerplate

The Commerce boilerplate has been updated with PDP video support, PLP page size configuration, 404 handling, layout improvements, multi-store wishlist integration, and B2B Quick Order and cart fixes:

Infrastructure

Build tools: @dropins/build-tools upgraded from ~1.0.1 to ~1.1.0 ( #1152 ).
Default assets: The assets enabled flag now defaults to true ( #1114 ).
Site config: Removed the folders reference from default-site.json ( #1148 ).

Fixes and improvements

PDP block: Video support out of the box for product media ( #1100 ).
PLP block: The page size is configurable via the block configuration; defaults to 9 ( #1143 ).
404 handling: Non-existent pages now return a correct server-rendered 404 so crawlers and tools receive the right HTTP status ( #1134 ).
Layout: Full-width sections and padding-based gutters in columns ( #1133 ).
URL manipulation: URL handling moved to the boilerplate ( #1119 ).
Wishlist: Multi-store wishlist drop-in integration ( #1139 ).
Demo config: The Adobe Commerce Optimizer flag was added to demo-config-aco.json ( #1124 ).
B2B (Cart): The View wishlist link includes the store code prefix in the PDP and Cart blocks ( #1130 ). The cart state is cleared when switching websites to prevent 403 errors ( #1137 ).
B2B (Quick Order): The Quick Order drop-in is integrated into the boilerplate ( #1125 , #1156 ).

February 17, 2026

Boilerplate Updates

Boilerplate

The Commerce boilerplate has been updated with Universal Editor model v2 support, new JSON block definitions for Document Authoring, infrastructure upgrades, and bug fixes:

Breaking changes:

Cards List block removed - The cards-list block has been removed. Use the cards block instead.
Fragment block behavior - Fragment blocks now replace their content directly instead of replacing the entire section wrapper, which may affect existing fragment implementations.

Document Authoring improvements:

Universal Editor model v2 - Upgraded component definitions to model v2 for improved authoring experience ( #1086 ).
Commerce block definitions - Added comprehensive JSON definitions for all commerce blocks including Account Header, Account Sidebar, Addresses, Cart, Checkout, Mini Cart, Orders List, Wishlist, and more, enabling visual authoring in Universal Editor and Document Authoring ( #1086 ).
Improved field naming - Block field definitions now use semantic names (such as image, text, summary) instead of CSS selector-based names ( #1086 ).
PDP default SKU support - Product Details Page block now supports defaultSku configuration in JSON definitions ( #1086 ).
PLP URL path configuration - Product List Page block now supports urlpath configuration for category detection ( #1086 ).
Enrichment block - Category enrichment reads URL path from PLP block configuration; preserves wrapper in Universal Editor for continued authoring ( #1086 ).

Infrastructure updates:

GitHub Actions updates - Workflow actions updated to latest versions (checkout@v6, setup-node@v6).
Automated Sidekick configuration - Sidekick configuration is now automated and no longer requires manual setup.
Drop-in SDK upgrade - @dropins/tools upgraded from ~1.6.0 to ~1.7.0 ( #1113 ).

Improvements and fixes:

Fragment block improvements - Fragment content now replaces block content directly, preserves block wrapper during DOM replacement ( #576 ), and properly handles external URLs preventing protocol-relative URL issues ( #577 ).
Header null safety - Navigation sections now include null checks preventing errors when sections are missing; navigation closes on focusout for improved keyboard accessibility ( #581 ).
AEM Assets protocol handling - createOptimizedPicture now correctly handles protocol-relative URLs (//) ( #582 ).
Product Details validation - PDP block now properly validates product data before rendering, preventing errors for missing products.
B2B address handling - Uses addressUid to prevent duplicate address entries during B2B checkout flows ( #1112 ).

January 8, 2026

Boilerplate Updates

Boilerplate

The Commerce boilerplate has been updated with the following changes:

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. Developers can now render PDPs in Universal Editor or Document Authoring on template pages using dedicated templates ( #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 and preloads order data, providing customers with immediate access to their order information and improving post-purchase experience ( #882 , #831 , #913 ).
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 - Improved rendering stability 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. Navigation automatically updates when company context changes ( #779 , #789 , #797 , #797 ).
Requisition List integration - Integrated requisition list drop-in into PDP and PLP blocks, enabling B2B users to add products to requisition lists. Includes routing between list grid and detail views ( #755 , #821 , #851 , #886 , #911 , #954 , #967 ).
Negotiable Quote blocks - Added B2B negotiable quote block and quote template block for managing quotes and quote templates. Includes quote checkout with dedicated summary containers, file uploads, and address management ( #778 , #884 , #890 , #892 , #906 , #916 , #1001 , #1002 , #999 , #1009 , #1013 , #1014 ).
Company Switcher integration - Integrated company switcher for multi-company B2B scenarios with context-aware page reloads and redirects for orders, purchase orders, and quotes. Includes inactive company filtering and product availability validation ( #701 , #914 , #976 , #982 , #1003 , #1024 ).
Purchase Order integration - Integrated Purchase Order drop-in with payment method, details page, and approval workflows. Includes permission-based access control and company context handling ( #736 , #826 , #900 , #902 , #909 , #931 , #938 , #942 , #964 , #966 ).
Company Management integration - Integrated company profile, users, structure, and roles & permissions management. Includes company creation workflow, drag-and-drop team organization, and comprehensive validation ( #726 , #745 , #816 , #832 , #838 , #865 , #926 , #960 , #974 , #984 , #986 , #993 , #996 ).
B2B permission system - Enabled customer permission roles in Auth initializer and checkout permissions handling. Permission system dynamically controls feature availability based on user roles ( #871 , #880 , #887 , #888 ).
Request quote from cart - Added ability to request negotiable quotes directly from the cart with minimum amount validation and user feedback ( #731 , #970 ).
Company context listeners - Added event listeners throughout the boilerplate to respond to company context changes, ensuring data consistency when switching companies ( #966 ).

October 14, 2025

Boilerplate Updates

Boilerplate

The Commerce boilerplate has been updated with the following changes:

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 - Breaking change: Product URLs now enforce lowercase SKUs. Sites with uppercase SKUs must ensure proper metadata mapping to prevent broken links ( #406 ). Metadata handling now works properly for multistore configurations with JSON-LD path resolution ( #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 )

August 12, 2025

Boilerplate Updates

Boilerplate

The Commerce boilerplate has been updated with the following changes:

Account drop-in fixes - Resolved various account drop-in functionality issues
Added carousel and cards-list components - Integrated carousel and cards-list components for enhanced product display capabilities
Architecture cleanup - Removed deprecated widgets and custom PLP components
Checkout compatibility - Fixed shipping methods infinite loop and iOS compatibility
Checkout update - Updated checkout drop-in to version 2.0.0-beta6
Commerce Storefront compatibility improvements - Enhanced compatibility with storefront-builder for improved UE integration
Documentation enhancement - Added comprehensive JSDoc comments to commerce.js
Global placeholders - Implemented global placeholders system
Header optimization - Optimized header’s mini-cart and search loading performance
Initialization optimization - Reordered main initialization in scripts.js for improved loading sequence
Modal localization - Fixed modal localized text display
PDP image zoom fix - Fixed image zoom icon display issues
Product discovery search fix - Fixed search item link functionality
reCAPTCHA enhancement - Enhanced reCAPTCHA initialization in initializeDropins function
Recommendations drop-in events - Recommendations drop-in now sends Adobe Client Data Layer events
Recommendations update - Updated @storefront-recommendations to v1.0.0
Removed default content from product-details block - Cleaned up default content from product-details block for cleaner implementation
Scripts refactoring - Major refactoring of scripts.js for improved maintainability
Wishlist improvements - Enhanced wishlist mobile alerts and cart integration

For complete details, see the Boilerplate Updates changelog entry .

June 24, 2025

Boilerplate Refactoring

Boilerplate

The scripts.js file has been refactored to align with the upstream AEM Boilerplate while extracting all commerce-specific functionality into scripts/commerce.js. This refactoring provides better separation of concerns and improved maintainability.

Key Changes:

scripts.js now contains only core AEM functionality (aligned with upstream AEM Boilerplate)
commerce.js now contains all commerce-specific functionality including:
- GraphQL queries and commerce backend connections
- Template handling and application
- Commerce page type detection
- Adobe Data Layer initialization
- Commerce utilities (rootLink, fetchPlaceholders, etc.)
- Modal auto-linking functionality
- Commerce-specific preloading logic

Import Updates Required: Developers need to update import statements from scripts/scripts.js to scripts/commerce.js for commerce-specific functions:

1
// Before
2
import { rootLink } from '../../scripts/scripts.js';
3
import { fetchPlaceholders } from '../../scripts/scripts.js';
4

5
// After
6
import { rootLink } from '../../scripts/commerce.js';
7
import { fetchPlaceholders } from '../../scripts/commerce.js';

See Storefront Architecture for more details about the refactoring and its benefits.

July 30, 2026

Drop-in SDK (Elsie) v2.0.0

Drop-in SDK

Breaking changes

TypeScript 6.0 and ESLint 9: The SDK’s TypeScript toolchain moves from 4.7 to 6.0, and ESLint moves from 8 to 9 with flat config. If you extend the shared @adobe-commerce/elsie/config/eslint configuration, migrate your own .eslintrc.js to a flat-config eslint.config.js, add "type": "module" to package.json, and rename .elsie.js to .elsie.cjs. See the migration guide in the StorefrontSDK repository for the full list of steps (#215).

New features

Incrementer validation: The Incrementer component now validates the field when its value is cleared (#204).
DROPINS.showOverlays(): A new developer utility outlines every drop-in container and slot on the page with labeled overlays, making it easier to see how a storefront page is composed at runtime. DROPINS.showSlots() is deprecated in its favor (#208).
Cypress ESLint config: A new optional cypress export from the shared ESLint config provides pre-configured flat-config rules for Cypress test files (#238).
elsie changeset CLI command: Wraps @changesets/cli as a first-class elsie command, so you no longer need to install @changesets/cli separately (#239).

Improvements and fixes

Testing tools: Jest upgraded to 30.4.2 and Storybook to 10.4.0 (#205).
@adobe-commerce/recaptcha: COMPANY_CREATE added to the default reCAPTCHA form map for B2B company registration (#206).
@adobe-commerce/event-bus: Added a TypeScript return type for events.lastPayload (#216).
Accessibility:
- Picker no longer leaves Add to Cart permanently disabled after single-option narrowing on configurable PDPs (#219).
- Accessible labels on password validation icons (#220).
- Picker’s accessible name and label association (#233).
- Screen reader announcements for Field and InLineAlert status and error messages (#253).
- Unique accessible names for InLineAlert action buttons (#242).
- Focus management and dialog semantics in Modal (#244).
- ToggleButton’s accessible name (#246) and invalid HTML ids when its value contains spaces (#262).
- Higher-contrast keyboard focus indicators across Button, Checkbox, RadioButton, and other interactive components.
InputDate: Fixed the input showing the wrong format after selecting a date from the calendar.

June 10, 2026

Drop-in SDK (Elsie) v1.9.0

Drop-in SDK

Improvements and fixes

Bundle optimizations: Lazy icon loading and code consolidation significantly reduce the number of HTTP requests on page load across all drop-ins. The Preact runtime is now isolated into its own vendor chunk. API functions, icons, and internal components are consolidated into chunks/api.js, chunks/icons.js, and chunks/components.js respectively. Measured reductions: Drop-in tools −29% (34→24 requests), Auth drop-in −75% (24→6), Cart drop-in −85% (13→2). TTI improved 22% on average. Drop-ins must be rebuilt against this SDK release to benefit (#200).
Node.js 22 LTS: The SDK and all drop-ins have been updated to require Node.js 22 LTS as the minimum build runtime (#201).
GraphQL fragment bundling fix: GraphQL fragment files are no longer incorrectly swept into chunks/api.js, which would break the boilerplate’s GraphQL override mechanism that depends on fragment strings being present in the standalone fragments.js output (#210).

April 30, 2026

Drop-in SDK (Elsie) v1.8.1

Drop-in SDK

The Drop-in SDK has been updated to 1.8.1 with the following improvements and fixes:

Improvements and fixes

Image srcset fix: The srcset attribute on product images is now generated correctly for all viewport breakpoints. An explicit sizes prop was added to the Image component to prevent incorrect attribute output (#187, #195).
reCAPTCHA Enterprise support: The SDK now supports reCAPTCHA Enterprise for improved bot protection on storefront forms (#189).

March 24, 2026

Drop-in SDK (Elsie) v1.8.0

Drop-in SDK

The Drop-in SDK (Elsie) has been updated with the following changes:

Internal build pipeline - Improvements to the build pipeline. There are no new user-facing SDK APIs in this release suite.

February 17, 2026

Drop-in SDK (Elsie) v1.7.0

Drop-in SDK

The Drop-in SDK (Elsie) has been updated with the following changes:

Custom content below row total - Allow custom content below cart item row total price ( #162 ).
Price display fix - Resolved issue with displaying prices.
RadioButton icon support - Added icon support to the RadioButton component.
Picker component behavior - Picker component is now disabled when only one option is available.

January 8, 2026

Drop-in SDK (Elsie) v1.6.0

Drop-in SDK

The Drop-in SDK (Elsie) 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 with better prop propagation ( #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 under the public namespace were incorrectly identified as multi-store configurations. This caused the Store Switcher to activate unnecessarily, resulting in rendering errors such as footer not loading due to missing store-switcher fragment. The detection logic now properly distinguishes actual store entries from other configuration keys ( #156 ).
FetchGraphQL instance linking - FetchGraphQL instances can now link to or inherit configuration from other instances, enabling shared endpoint, header, and hook management across multiple instances. This reduces configuration duplication when creating multiple API clients with similar settings and provides better architecture for complex drop-in implementations. When an instance is linked to another, it delegates all configuration operations (setEndpoint, setFetchGraphQlHeader, addBeforeHook, addAfterHook) to the linked instance, ensuring consistent behavior across related API clients ( #145 , #147 , #148 ).

July 30, 2026

Cart v3.3.1

Cart

The Cart drop-in has been updated with the following changes:

Improvements

Backorder messaging: When Adobe Commerce returns a backorder message for a cart line, shoppers now see that message instead of a generic “limited stock” warning or an incorrect out-of-stock state (#112).

Fixes

Gift wrapping: Fixed a bug where unchecking “Gift wrap this item” didn’t remove the gift wrapping charge (#157).
Accessibility:
- Added a missing icon label in the gift options accordion, WCAG 1.1.1 (#151).
- Stopped the Mini Cart footer from being pushed off-screen at reduced viewport heights (#152).
- Added missing autocomplete attributes on the estimated shipping form, WCAG 1.3.5 (#154).
- Marked the gift wrapping modal title as a heading (#155).
- Gave the “Apply” buttons for estimated shipping, discount code, and gift card distinct accessible names instead of a shared generic “Apply”, WCAG 2.4.6 (#159).
- Marked heading text in Cart and Mini Cart as real headings (#160).
- Clarified the discount code input’s accessible name, WCAG 2.5.3 (#163).
- Added a screen reader announcement for the empty-cart message, WCAG 4.1.2 (#164).
Cleanup: Removed a dead useFocusTrap hook left over from a previous fix (#162).

June 10, 2026

Cart v3.3.0

Cart

New features

confirmBeforeDelete prop: When confirmBeforeDelete={true} is passed to CartSummaryList or MiniCart, clicking the remove button replaces the item row with an inline confirmation banner instead of immediately deleting the item. The banner prompts “Remove ‘[product name]’ from your cart?” with Remove and Cancel actions. A ConfirmDeleteBanner slot is available on both containers for full UI customization. All new props default to the previous behavior, so no changes are required for existing implementations (#138).

Infrastructure

Node.js 22 LTS: The package now builds and distributes using Node.js 22 LTS. The engines.node constraint has been removed as this drop-in targets browser environments exclusively.

March 24, 2026

Cart v3.2.0

Cart

The Cart drop-in has been updated with the following changes:

Out-of-stock and insufficient-quantity items in the main list - The CartSummaryList container now accepts an optional includeOutOfStockItems prop (default false). When set to true, out-of-stock and insufficient-quantity items appear in the main cart item list alongside in-stock items. The alert banner remains visible with its heading, description, and actions (for example, “Remove all out of stock items”), but the item rows inside the banner are hidden from view and marked for screen readers. Default behavior is unchanged ( #102 ).
Multi-store wishlist integration - The boilerplate now wires the multi-store wishlist drop-in into the Cart block ( #1139 ).
B2B - The View wishlist link includes the store code prefix in the PDP and Cart blocks; cart state is cleared when users switch websites to prevent 403 errors ( #1130 , #1137 ).

February 17, 2026

Cart v3.1.0

Cart

The Cart drop-in has been updated with the following changes:

RowTotalFooter slot - New slot in Cart and Mini Cart containers enables custom content below each item’s row total price. Useful for displaying loyalty points, rewards, or custom pricing information ( #91 ).

January 8, 2026

Cart v3.0.0

Cart

Major version upgrade with improved B2B integration and event handling. The Cart drop-in component has been updated to include the following changes:

HTML entity decoding - Product names with special characters (quotes, ampersands, etc.) now display correctly throughout the cart UI. The decoding applies to product titles, remove button aria-labels, and undo notification messages ( #90 ).
Requisition list integration - Cart now automatically refreshes when products are moved between cart and requisition lists via the requisitionList/alert event, ensuring B2B workflows stay synchronized ( #80 ).
Cart open event fix - The “cart open” event now fires correctly when the first item is added to an empty cart. Previously it only triggered when creating a new cart, but now properly detects the transition from empty to having items ( #84 ).
Start checkout event fix - The “start checkout” event now publishes correctly when initiating checkout. Added navigation delay to ensure analytics events are sent before page navigation ( #81 ).
Checkout event filtering - Cart now properly filters checkout/updated events by type (cart vs quote), preventing unnecessary cart refreshes when quote-related checkout events occur ( #87 ).
Gift options styling fix - Gift options textarea label hiding rule is now properly scoped to only affect textarea labels within the gift options view, preventing unintended effects on other form elements ( #88 ).
Company context event handling - Removed handling of companyContext/changed event from initialize module as it’s no longer needed ( #91 ).
Revised Adobe Commerce Drop-in License Agreement - Updated license agreement to current terms. B2C drop-ins have been tested on Adobe Commerce as a Cloud Service (ACCS) and Adobe Commerce 2.4.7+ for Platform-as-a-Service (PaaS) deployments. However, the license agreement restricts use to Adobe Commerce as a Cloud Service (ACCS) and Adobe Commerce Optimizer (ACO) only. Use on Platform-as-a-Service (PaaS) or on-premise deployments is not permitted under the license agreement ( #89 ).

October 14, 2025

Cart v1.5.1

Cart

The Cart drop-in component has been updated to include the following changes:

Tiered pricing now available: The cart automatically applies quantity-based discounts to eligible items. This feature integrates with GraphQL to fetch price tier data, matches the best discount for the current quantity, and calculates savings percentages. Both simple and configurable products display their applicable tiers clearly in the cart UI ( #70 ).
Smarter configurable product handling: When you modify a configurable product’s options, the cart now intelligently merges it with existing items that have matching configurations. This consolidates quantities and removes duplicates for a cleaner experience. We also fixed an issue where updating items with identical options would incorrectly increase quantity instead of maintaining the current amount ( #69 ).
B2B company context support: The cart automatically refreshes when company context changes, keeping contents and pricing synchronized with your current B2B company for multi-company scenarios ( #65 ).
Cross-tab logout sync: Cart state now stays consistent across browser tabs after user logout, ensuring the same cart behavior in all active sessions ( #62 ).
Clearer tax information: Virtual carts without applied taxes now show “TBD” until checkout begins, then display the actual tax values. This provides clearer tax information throughout the checkout flow ( #72 ).
Better quantity validation: Quantity field validation now properly handles maximum values, ensuring accurate input constraints ( #68 ).
Accessibility improvements: Lighthouse accessibility scores are now higher thanks to proper aria-labels for quantity inputs and improved keyboard navigation for screen readers ( #67 ).

August 12, 2025

Cart v1.5.0

Cart

The Cart drop-in component has been updated to include the following changes:

Extended Add/Update Cart API: Added support for custom fields in the addToCart() and updateProductsFromCart() API functions, enabling developers to set and update custom cart item fields such as standard_height and custom_height during cart operations.
Fixed missing Channel Field: Fixed an issue where the channel attribute was missing from all Adobe Experience Platform (AEP) events on the Product Details Page. The channel field is now properly populated as part of the global storefront context for all PDP events, ensuring complete event data collection.
Added undo remove cart items: Introduced configurable functionality to allow users to undo item removals from the cart. When enabled, removed items display an undo banner in their original position while cart totals reflect the removal, with the ability to reinstate items with their original quantity and options. The feature works with both built-in remove buttons and the updateProductsInCart API, with customizable undo banner styling.
Enhanced mini cart flexibility: Redesigned the mini cart layout with reduced container nesting and improved slot architecture, allowing developers to easily wrap individual elements (price, product title, quantity), customize action button placement and styling, add quantity stepper labels, and include specific product attributes with comprehensive documentation.

June 25, 2025

Cart v1.4.0

Cart

Fixed the alignment of the Apply button text in the gift wrapping customization, ensuring it now matches the intended design.
Resolved an edge case where updating a cart item with the same options and quantity could unexpectedly remove the item from the cart.
The cart open AEP event now correctly includes productListItems, providing more accurate event data.
The cart view AEP event now includes selected product options and discount information in productListItems.
The add to cart AEP event now populates selected options for complex and bundled products, improving event tracking accuracy.
The start checkout AEP event now includes available product discount information in productListItems.
The cart summary list can now be rendered in a customizable column layout, allowing brands to better match their design guidelines.

July 30, 2026

Checkout v3.3.1

Checkout

The Checkout drop-in has been updated with the following changes:

Fixes

Accessibility: Added a visually-hidden “Shipping option” prefix to each shipping method’s accessible name, so its purpose is clear without relying on the surrounding heading, WCAG 2.4.6 (#344). Associated the payment method radio buttons with their “Payment” group label, so screen readers announce the group and the correct option count for each choice, WCAG 1.3.1 (#345).

June 10, 2026

Checkout v3.3.0

Checkout

New features

checkout/layout extension hook: Customize the checkout page structure — reorder, hide, move, group, or inject sections — without modifying the base block code. See Extending the checkout drop-in for usage details and the custom-layout example extension (#318).

Infrastructure

Node.js 22 LTS: The package now builds and distributes using Node.js 22 LTS. The engines.node constraint has been removed as this drop-in targets browser environments exclusively.

April 30, 2026

Checkout v3.2.1

Checkout

The Checkout drop-in has been updated with the following changes:

Vault payment method support: The PaymentMethods container now forwards the full additionalData payload to setPaymentMethodOnCart, enabling Payment Services vault and other payment methods that require extra fields to send the correct GraphQL mutation variables (#311).

March 24, 2026

Checkout v3.2.0

Checkout

The Checkout drop-in has been updated with the following changes:

ShippingMethods ( #300 ) - A new ShippingMethodItem slot replaces the default radio/toggle UI per method while keeping selection wired to the API (replaceWith, onSelect, onRender). The slot context is ShippingMethodItemContext (method, isSelected, onSelect). The busy flag applies to the internal shipping-methods UI when updates or an estimate are pending, not to the slot context. See Shipping methods and ShippingMethods slots.
estimateShippingMethods ( #307 ) - Extend the shipping estimate payload at build time using ESTIMATE_SHIPPING_METHOD_FRAGMENT and the EstimateShippingModel initializer. See Extending the checkout drop-in.

February 17, 2026

Checkout v3.1.0

Checkout

The Checkout drop-in has been updated with the following changes:

Preferences slot in LoginForm - New slot enables adding email preferences or custom content within the checkout login form ( #269 ).
Discounted shipping display - Shipping methods with discounts now display the original price with strikethrough, helping customers see their savings ( #270 ).
Custom form field placeholders - Form fields now support custom placeholders and floating labels for improved UX customization ( #291 ).
Async place-order validation - PlaceOrder.handleValidation now accepts Promise<boolean> in addition to boolean, enabling asynchronous validation (such as server-side fraud checks) before placing orders.
Adyen Bancontact support - Added support for Adyen Bancontact payment method ( #294 ).
Adyen payment extensions - Enhanced Adyen payment integration with additional extension support ( #282 ).

January 8, 2026

Checkout v3.0.0

Checkout

Major version upgrade with comprehensive B2B checkout support. The Checkout drop-in has been updated to include the following changes:

B2B Features:

Payment on Account - New payment method for B2B transactions allowing customers to pay using their company account. Includes getCompanyCredit API to retrieve available credit and credit limit information, with validation to prevent exceeding credit limits ( #183 , #185 , #188 , #192 , #206 ).
Purchase Order - New payment method enabling B2B customers to reference purchase order numbers during checkout, with validation to ensure required PO numbers are provided ( #190 , #194 , #195 , #207 ).
Quote checkout support - Checkout now distinguishes between regular carts and negotiable quotes with separate event handling and containers. Quote checkout uses dedicated QuoteSummaryList and OrderSummary containers for B2B quote workflows ( #209 , #213 , #220 , #228 ).
Checkout permissions - B2B users without checkout permissions now see appropriate error messages. Permission validation distinguishes between cart and quote checkouts ( #208 , #224 , #229 ).

Improvements:

Event type filtering - Checkout events (checkout/initialized and checkout/updated) now include a type property to distinguish between cart and quote operations, enabling proper event handling for both workflows ( #230 ).
Billing address updates - Billing address now uses customerAddressUid instead of numeric IDs for better compatibility with B2B quote workflows and customer address management ( #198 ).
Checkout success flow - Checkout success page is now properly decoupled, preventing empty cart flashes and ensuring smooth transition to order confirmation ( #205 , #223 ).
Placeholder-based translations - Implemented comprehensive placeholder-based translation system for all checkout UI strings, enabling easier localization for AEM placeholders ( #251 , #252 ).
Empty cart handling - Users are now redirected to cart page when cart is empty (except on order confirmation page), preventing checkout access with empty carts ( #258 ).
Payment method auto-selection - When the currently selected payment method becomes disabled, the first available method is automatically selected to maintain checkout flow ( #215 , #221 ).
Fastlane disabled - Fastlane payment method is now disabled for B2B checkout to prevent conflicts with B2B payment workflows ( #197 ).

Fixes:

Login on empty cart - Fixed issue where login functionality failed when cart was empty ( #201 ).
Billing address sync - Fixed issue where billing address was not updated when re-checking “bill to shipping” checkbox ( #255 ).
Gift options spacing - Removed unnecessary empty space for gift options container when not in use ( #247 ).
Signup modal - Signup modal now closes properly after account creation ( #245 ).
Shipping method auto-selection - Fixed issue where Quote checkout would lose shipping methods after auto-selection ( #231 ).
B2B address handling - Fixed checkout failure when B2B user has no saved addresses ( #218 ).
Error message rendering - Error messages now render properly throughout the checkout flow ( #187 ).
Revised Adobe Commerce Drop-in License Agreement - Updated license agreement to current terms. B2C drop-ins have been tested on Adobe Commerce as a Cloud Service (ACCS) and Adobe Commerce 2.4.7+ for Platform-as-a-Service (PaaS) deployments. However, the license agreement restricts use to Adobe Commerce as a Cloud Service (ACCS) and Adobe Commerce Optimizer (ACO) only. Use on Platform-as-a-Service (PaaS) or on-premise deployments is not permitted under the license agreement ( #259 , #260 ).

October 14, 2025

Checkout v2.1.0

Checkout

The Checkout drop-in has been updated to include the following changes:

New utility library: The checkout now includes reusable utilities for address transformation, form validation, cart state management, and shipping cost estimation. This improves code reusability across different checkout implementations ( #88 , #146 ).
Free orders now supported: Zero-cost checkouts (when coupons or promotions cover the full total) now have dedicated payment method display and handling ( #170 ).

August 12, 2025

Checkout v2.0.1

Checkout

The checkout drop-in component has been updated to include the following changes:

Miscellaneous bug fixes and enhancements.

The Multi-step checkout tutorial has been updated, providing a customizable example to implement a comprehensive multi-step checkout based on a modular architecture (event-driven step coordination) that supports the following scenarios:

Guest users
Logged-in customers
Virtual products
Mixed carts (physical + virtual product combinations)

June 25, 2025

Checkout v2.0.0

Checkout

The checkout drop-in component GraphQL API has been extended exposing new fragments:

BILLING_CART_ADDRESS_FRAGMENT
SHIPPING_CART_ADDRESS_FRAGMENT
AVAILABLE_PAYMENT_METHOD_FRAGMENT
SELECTED_PAYMENT_METHOD_FRAGMENT

The Error Handling has been implemented in some containers (still work in progress):

BillToShippingAddress
LoginForm
PaymentMethods
ShippingMethods

The Event Handling has been documented within the list of events emitted and subscribed by the checkout drop-in component containers.

A new Active property has been added for all containers: This property activates/deactivates the container.

A new AutoSync property has been added for some containers: This property allows the container to automatically synchronize its state changes with the backend.

A new TitleProps interface has been created to customize the title and header of some containers.

The BillToShippingAddress container configuration structure has been modified. A new property has been added to the BillToShippingAddressProps interface:

BillToShippingAddressProps.onCartSyncError property added: This property allows performing some actions if an error is thrown when the bill to shipping checkbox is checked.

Implemented an error handling mechanism for the BillToShippingAddress container based on the “Optimistic” UI updates with rollback pattern consisting of the following:

It provides a callback function onCartSyncError() to be used in the integration layer in case the merchant wanted to perform some actions like showing an error message etc.
It performs a rollback reverting to the previous valid checkbox state.
In case the callback is not implemented, a fallback will be used, which consists of displaying an inline alert message.

The LoginForm container configuration structure has been modified. New properties have been added to the LoginFormProps interface:

LoginFormProps.displayHeadingContent property added: This property allows displaying the container heading content.
LoginFormProps.slots.Heading property added: This property allows customizing the container heading content based on the user authentication status.

Additionally, the following properties have been added, extending the TitleProps interface:

LoginFormProps.displayTitle property inherited: This property allows displaying the container title.
LoginFormProps.slots.Title property inherited: This property allows customizing the container title.

The PaymentMethods container configuration structure has been modified. Deprecated properties have been removed from the PaymentMethodsProps interface:

PaymentMethodsProps.setOnChange deprecated property removed.
PaymentMethodsProps.slots.Handlers deprecated property removed.

Additionally, the following property has been renamed:

PaymentMethodsProps.slots.Methods[code].setOnChange property renamed to PaymentMethodsProps.slots.Methods[code].autoSync.

Additionally, the following properties have been added:

PaymentMethodsProps.onSelectionChange property added: This property allows performing some actions when a payment method is selected.
PaymentMethodsProps.onCartSyncError property added: This property allows performing some actions if an error is thrown during the payment method selection.
PaymentMethodsProps.UIComponentType property added: This property allows using a different UI component type as a selector for each payment method. UI components available are: ‘ToggleButton’ and ‘RadioButton’.

Additionally, the following properties have been added, extending the TitleProps interface:

PaymentMethodsProps.displayTitle property inherited: This property allows displaying the container title.
PaymentMethodsProps.slots.Title property inherited: This property allows customizing the container title.

Implemented an error handling mechanism for the PaymentMethods container based on the “Optimistic” UI updates with rollback pattern consisting of the following:

It provides a callback function onCartSyncError() to be used in the integration layer in case the merchant wanted to perform some actions like showing an error message etc.
It performs a rollback reverting to the previous valid payment method selected.
In case the callback is not implemented, a fallback will be used, which consists of displaying an inline alert message.

The ShippingMethods container configuration structure has been modified. A property has been removed from the ShippingMethodsProps interface:

ShippingMethodsProps.preSelectedMethod property removed: This was an obsolete and unused property without business logic behind.

Additionally, the following property has been renamed:

ShippingMethodsProps.onShippingMethodSelect property renamed to ShippingMethodsProps.onSelectionChange.

Additionally, the following properties have been added:

ShippingMethodsProps.onCartSyncError property added: This property allows performing some actions if an error is thrown during the shipping method selection.
ShippingMethodsProps.UIComponentType property added: This property allows using a different UI component type as a selector for each shipping method. The available UI components are: ToggleButton and RadioButton.

Additionally, the following properties have been added, extending the TitleProps interface:

ShippingMethodsProps.displayTitle property inherited: This property allows displaying the container title.
ShippingMethodsProps.slots.Title property inherited: This property allows customizing the container title.

Implemented an error handling mechanism for the ShippingMethods container based on the “Optimistic” UI updates with rollback pattern consisting of the following:

It provides a callback function onCartSyncError() to be used in the integration layer in case the merchant wanted to perform some actions like showing an error message etc.
It performs a rollback reverting to the previous valid shipping method selected.
In case the callback is not implemented, a fallback will be used, which consists of displaying an inline alert message.

The TermsAndConditions container is now visible for both the anonymous and authenticated checkout processes.

March 6, 2025

Checkout v1.3.0

Checkout

A new TermsAndConditions container has been added.

February 11, 2025

Checkout v1.2.0

Checkout

The PlaceOrder container configuration structure has been modified. A new property has been added to the PlaceOrderProps interface:

PlaceOrderProps.slots.Content property added: This property allows setting the container content based on the selected payment method. This addresses how to set the container content dynamically based on the selected payment method, instead of having to modify the text of the container by manipulating the DOM directly and detecting payment method selection by handling the PaymentMethods slot, which is not ideal for maintainability.

February 3, 2025

Checkout v1.1.0

Checkout

The PaymentMethods container configuration structure has been modified. The PaymentMethodsProps interface has been changed and some properties have been deprecated and replaced:

PaymentMethodsProps.setOnChange property @deprecated: This property is deprecated and will be removed in future versions. It has been replaced by the following: PaymentMethodsProps.slots.Methods.<payment-method-code>.setOnChange.
PaymentMethodsProps.slots.Handlers property @deprecated: This property is deprecated and will be removed in future versions. It has been replaced by the following one: PaymentMethodsProps.slots.Methods.<payment-method-code>.render.
PaymentMethodsProps.slots.Methods property added: This property is an object that consists of a list of payment method codes that provide a set of configurations to customize each payment method individually.

Configurations accepted by payment methods:
- The displayLabel configuration hides the payment method label (for example, if you only want to display the icon).
- The enabled configuration allows merchants to individually hide payment methods filtering them from the available payment methods list (for example, it is useful when a payment provider has enabled a payment method in the backend, which is configured with more than one payment option and you don’t want to display one of them).
- The icon configuration specifies the name of the icon to be shown beside of the label. The icon name must exist within the list of available icons defined in the drop-ins SDK.
- The setOnChange configuration sets the payment method automatically when it is selected. Only if a payment method is specifically set to false, the container will not automatically set the payment method to the cart when selected (for example, if a payment method needs to obtain more information during the place order action).
- The render configuration is a handler used to render and configure the payment method.

July 30, 2026