Cart changelog

July 30, 2026

Cart v3.3.1

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

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

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

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

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

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

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

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