Changelog

Order changelog

July 30, 2026

Order v4.0.1

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

Fixes

Accessibility: Fixed incorrect and missing autocomplete attributes on the guest order search form’s email and last name fields, WCAG 1.3.5 (#140). Marked heading text across order status, order details, shipping, returns, and product list sections as real headings (#142).

June 10, 2026

New features

Seller Assisted Buying label on orders: Orders placed by a store administrator on behalf of a customer now display a visible “Order placed by an administrator” label on the order details page. The feature integrates with order comments to provide a history of administrative actions throughout the order lifecycle (#91).

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

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

Order Comments container: Merchants and administrators can add comments to orders in Commerce Admin and mark them as “Visible on Storefront.” Comments marked visible now appear with timestamp and message in the order details view for both guest and authenticated shoppers. This also resolves a gap where comments marked visible in Commerce Admin were silently missing from the storefront. The new OrderComments container fetches comments for guest orders (via order token) and authenticated customer orders alike. Add the commerce-order-comments boilerplate block to any order details page to render the view (#68, #87).
Unified date/time formatting: A single formatDateToLocale export replaces the previous two separate formatters. Use the FORMAT_DATETIME constant for long date-and-time display (for example, comment timestamps). Date-only formatting is unchanged.

February 17, 2026

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

Gift wrapping availability - Added gift_wrapping_available field to order item product details, enabling conditional display of gift wrapping options based on product configuration ( #65 ).

January 8, 2026

Major version upgrade with B2B company context support. The Order drop-in has been updated to include the following changes:

Company context switching - Order data now automatically refreshes when B2B users switch companies, ensuring users only see orders relevant to their current company context. When switching companies, the drop-in fetches fresh order data to maintain data integrity across company contexts ( #53 , #55 ).
Enhanced error handling - Improved error handling for company context changes with automatic redirect to orders list when network errors occur or when users lack access to an order in the new company context. This prevents displaying stale or inaccessible order data ( #53 , #55 ).
Negotiable quote order placement - Updated GraphQL mutation from placeNegotiableQuoteOrder to placeNegotiableQuoteOrderV2 with improved error handling that properly surfaces backend errors instead of silently failing.
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.

October 14, 2025

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

Better order placement consistency: PlaceOrderFragment now uses a shared GUEST_ORDER_FRAGMENT pattern, making order placement operations more consistent with standardized error handling ( #43 ).
Personal email in analytics events: Adobe Client Data Layer integration now includes personal email context in place order events for complete customer identification ( #45 ).
More detailed order tracking: OrderContext now includes paymentAmount and priceTotal fields, plus discountAmount in cart item tracking for better financial reporting ( #45 ).
Smarter returns pagination: Returns list pagination only scrolls when you’re not already at the top of the page, improving the user experience ( #44 ).

August 12, 2025

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

Fixed cancelled product display: Corrected the CartSummaryItem user experience to properly handle cancelled products by removing the strikethrough text and “out of stock” message that were incorrectly appearing for cancelled orders.
Fixed missing Channel Field: Added the channel attribute to all Adobe Experience Platform (AEP) events in the Order drop-in, ensuring complete event data collection as part of the global storefront context.
Fixed reCAPTCHA v3 integration: Resolved issues where reCAPTCHA v3 was preventing order placement and blocking user authentication functions (login, account creation, password reset), with solution provided to the ACS team.
Fixed cancelled product messaging: Resolved an issue where cancelled products incorrectly displayed strikethrough text and “out of stock” messages in the CartSummaryItem component, ensuring proper visual representation of cancelled order items.

June 25, 2025

Added a new setPaymentMethodAndPlaceOrderMutation API for the Order Drop-in, enabling atomic payment and order placement` to better support providers like Adyen.
Added missing listImage slot props to the ReturnsList container.
You can now customize the translation for the order gift wrapping title on the checkout success page, allowing for proper localization.
Fixed an issue where the CartSummaryItemImage slot was not triggered on the return items page, ensuring custom images now display correctly during returns.