Storefront Compatibility Package changelog

August 3, 2026

Storefront Compatibility Package v4.9.3, v4.8.28, v4.7.15

The Storefront Compatibility Package has been updated to include the following changes:

• Sales Rule - Free Gift:

  • Added support for Free Gift promotions through Shopping Cart Price Rules.
  • Added gift_sku and gift_qty extension attributes to Magento\SalesRule\Api\Data\RuleInterface.
  • Added the available_free_gifts field to the Cart type to expose eligible free gift options.
  • Added the selectFreeGiftForCart mutation to allow customers to select a free gift for the cart.
  • Added the is_free_gift field to CartItemInterface to identify free gift line items.
  • Added GraphQL validation to enforce free gift eligibility, quantity limits, and required gift selection before order placement.

• Product Alert:

  • Added GraphQL support for Product Alert subscriptions in the Storefront Compatibility Package.
  • Added subscribeProductAlertStock, unsubscribeProductAlertStock, and unsubscribeProductAlertStockAll mutations for back-in-stock alerts.
  • Added subscribeProductAlertPrice, unsubscribeProductAlertPrice, and unsubscribeProductAlertPriceAll mutations for price-drop alerts.
  • Added isSubscribedProductAlertStock and isSubscribedProductAlertPrice queries to check product alert subscription status.

July 14, 2026

Storefront Compatibility Package v4.9.2, v4.8.27

The Storefront Compatibility Package has been updated to include the following changes:

• Persistent Shopping Cart and Customer: Adds share_customer_accounts_scope, persistent_enabled, persistent_shopping_cart, and persistent_options_wishlist to the storeConfig query. These fields expose the customer account share scope and the persistent cart and wishlist settings for the store.
• Login as Customer: Fixed an issue where the add_to_cart event was not being logged when products were added to the cart using the Login as Customer feature.

July 3, 2026

Storefront Compatibility Package v4.9.1, v4.8.26, v4.7.14

The Storefront Compatibility Package has been updated to include the following changes:

• GraphQL Input Limits: Raises the default for Maximum Alias Allowed from 10 to 15, configured at Stores > Settings > Configuration > Services > Web API > GraphQL Input Limits in the Admin. Storefront drop-ins need the higher limit because the @dropins/tools reCAPTCHA integration batches multiple recaptchaFormConfig calls into one query, with one alias per protected form.

June 2, 2026

Storefront Compatibility Package v4.9.0

The Storefront Compatibility Package has been updated with the following enhancements and fixes:

• Login as Customer:

  • Added support for seller-assisted buying through GraphQL using one-time passwords (OTP) generated from Admin.
  • Added admin_assistance_actions to the Customer type and admin_assisted_order to the CustomerOrder type.
  • Added exchangeOtpForCustomerToken mutation support alongside generateCustomerToken.
  • Added reCAPTCHA validation for generateCustomerToken with optional bypass support for exchangeOtpForCustomerToken.
  • Added the assistance_allowed field as part of the extension_attributes in the GET /V1/customers/:customerId REST API to indicate whether a customer has enabled admin assistance for their account.

• Cart and Product Availability:

  • Added is_salable and backorder_message fields to improve salability and backorder messaging support.
  • Fixed configurable products with custom options returning internal server errors when querying not_available_message or is_available.
  • Fixed availability checks for products where Manage Stock is disabled.
  • Resolved incorrect only_x_left_in_stock values for products with backorders enabled.
  • Fixed incorrect PRODUCT_NOT_FOUND errors for out-of-stock products and now correctly returns INSUFFICIENT_STOCK.

• Cart and Checkout Improvements:

  • Fixed guest cart functionality after customer logout.
  • Resolved guest checkout failures when using an email associated with a registered customer.
  • Fixed configurable products with identical options creating duplicate cart entries instead of updating quantity.
  • Resolved issues with shipping address custom attributes not persisting when using same_as_shipping: true.

• Wishlist Enhancements:

  • Fixed wishlist item and item count inconsistencies across multiple store views within the same website.

• Order and Order Item Enhancements:

  • Resolved issues in requestGuestOrderCancel, cancelOrder, and confirmCancelOrder mutations related to order comments.
  • Fixed state-leak issues in Order Item responses caused by shared object properties.
  • Corrected configurable product image data returned in Order API responses.

• Customer Groups and Customer Segments:

  • Added uid as an extension attribute in /V1/customerGroups/search REST API responses.
  • Added new /V1/customerSegments/search REST API endpoint to retrieve customer segments using integration or IMS tokens.

May 29, 2026

Storefront Compatibility Package v4.8.25

The Storefront Compatibility Package has been updated to include the following changes:

• Login as Customer: Exposed the assistance_allowed field as an extension attribute in customer REST API responses.
• Platform Compatibility: Improved compatibility and test coverage for AC-2.4.8-p5.

May 20, 2026

Storefront Compatibility Package v4.8.24

The Storefront Compatibility Package has been updated to include the following changes:

• Login as Customer: Fixed a backend popup issue with one-time password (OTP) generation for Login as Customer.

May 13, 2026

Storefront Compatibility Package v4.8.23

The Storefront Compatibility Package has been updated to include the following changes:

• Login as Customer: Refactored Login as Customer for Adobe Commerce as a Cloud Service compatibility by making the reason field optional on the OTP REST API, adding reCAPTCHA validation for generateCustomerToken, and adding an option to bypass reCAPTCHA validation for exchangeOtpForCustomerToken.

May 12, 2026

Storefront Compatibility Package v4.8.22

The Storefront Compatibility Package has been updated to include the following changes:

• Cart Items: Fixed an issue where a configurable product with custom options returned an internal server error when the not_available_message or is_available fields were queried.

May 6, 2026

Storefront Compatibility Package v4.8.21

The Storefront Compatibility Package has been updated to include the following changes:

• Cart Items: Added is_salable flag to indicate salability and backorder_message to provide customer-facing guidance for backordered items.

May 4, 2026

Storefront Compatibility Package v4.7.13

The Storefront Compatibility Package has been updated to include the following changes:

• Add to Cart: Resolved an issue that caused guest cart functionality to fail after a customer logout. Products can now be added to the cart, and guest shopping works as expected.

April 27, 2026

Storefront Compatibility Package v4.8.20

The Storefront Compatibility Package has been updated to include the following changes:

• Add to Cart: Fixed an issue where out-of-stock products incorrectly returned a PRODUCT_NOT_FOUND error instead of INSUFFICIENT_STOCK.

April 20, 2026

Storefront Compatibility Package v4.8.19

The Storefront Compatibility Package has been updated to include the following changes:

• Login as Customer: A new Login as Customer feature supports seller-assisted buying. Admins can generate a one-time password (OTP) from the customer view in Admin and use it to authenticate as the customer through GraphQL. The schema adds admin_assistance_actions on the Customer type to record admin activity and admin_assisted_order on the CustomerOrder type for orders placed with assistance. The exchangeOtpForCustomerToken mutation exchanges the OTP for a customer token and works alongside generateCustomerToken.
• Wishlist Items: Fixed inconsistencies in wishlist items and item count across multiple store views within the same website. Wishlist data is now properly synchronized.
• Cart Items: Fixed cart availability checks for products where “Manage Stock” is disabled. Cart items now correctly return availability status.

April 17, 2026

Storefront Compatibility Package v4.7.12

The Storefront Compatibility Package has been updated to include the following changes:

• Order Cancellation: Fixed issues with order comments in the response for the requestGuestOrderCancel, cancelOrder, and confirmCancelOrder mutations.

April 13, 2026

Storefront Compatibility Package v4.8.18

The Storefront Compatibility Package has been updated to include the following changes:

• Order Cancellation: Resolved issues in requestGuestOrderCancel, cancelOrder, and confirmCancelOrder mutations related to order comments in the response.

March 24, 2026

Storefront Compatibility Package v4.8.17

The Storefront Compatibility Package has been updated to include the following changes:

• PHP 8.5 support: Added PHP 8.5 support to all modules in the Storefront Compatibility Package.

February 16, 2026

Storefront Compatibility Package v4.8.16

The Storefront Compatibility Package has been updated to include the following changes:

• Add to Cart: Resolved an issue that caused guest cart functionality to fail after a customer logout. Products can now be added to the cart, and guest shopping works as expected.

January 12, 2026

Storefront Compatibility Package v4.8.15

The Storefront Compatibility Package has been updated to include the following changes:

• Quote Address: Resolved an issue where custom attributes on shipping addresses were lost while batching setShippingAddressesOnCart with setBillingAddressOnCart using same_as_shipping: true, ensuring attributes persist and are correctly copied to billing addresses.

December 5, 2025

Storefront Compatibility Package v4.8.14

The Storefront Compatibility Package has been updated to include the following changes:

• Order Items: Resolved a state-leak issue where Order Item data persisted between requests because shared object properties were not reset.

November 26, 2025

Storefront Compatibility Package v4.8.13

The Storefront Compatibility Package has been updated to include the following changes:

• Order Items: Resolved incorrect product image data in the Order API response for configurable products.

November 19, 2025

Storefront Compatibility Package v4.8.12

The Storefront Compatibility Package has been updated to include the following changes:

• Cart Items: Resolved an issue where only_x_left_in_stock returned null in the cart details response for products with backorders enabled. The problem was caused by incorrect calculations of the out-of-stock threshold.

November 10, 2025

Storefront Compatibility Package v4.8.11

The Storefront Compatibility Package has been updated to include the following changes:

• Customer Groups: Added uid as an extension attribute to customer groups in the /V1/customerGroups/search REST API response.
• Customer Segments: Introduced a new REST API endpoint /V1/customerSegments/search to retrieve customer segments using an integration or IMS token.

October 24, 2025

Storefront Compatibility Package v4.8.10

The Storefront Compatibility Package has been updated to include the following changes:

• Place order: Resolved an issue where guest checkout failed when the guest uses an email address associated with a registered customer.

October 20, 2025

Storefront Compatibility Package v4.8.9

The Storefront Compatibility Package has been updated to include the following changes:

• Add to Cart: Resolved an issue where adding the same configurable product with identical options created separate entries instead of updating the existing item’s quantity.

October 8, 2025

Storefront Compatibility Package v4.8.8

The Storefront Compatibility Package has been updated to include the following changes:

• Customer ID: Removed the deprecation notice for the GraphQL Customer.id field. This field returns the correct value that can be reused for B2B company management mutations/queries.
• Negotiable Quote Address: Aligned multiple address input types to support customer address UIDs, deprecating customer address IDs. Introduced the deleteCustomerAddressV2 and updateCustomerAddressV2 mutations and deprecated the previous versions.

October 8, 2025

Storefront Compatibility Package v4.7.11

The Storefront Compatibility Package has been updated to include the following changes:

• Negotiable Quote Address: Aligned multiple address input types to support customer address UIDs, deprecating customer address IDs. Introduced the deleteCustomerAddressV2 and updateCustomerAddressV2 mutations and deprecated the previous versions.

September 8, 2025

Storefront Compatibility Package v4.8.7, v4.7.10

The Storefront Compatibility Package has been updated to include the following changes:

• Historical Orders Fixes: Ensured stability in order flows by returning null for missing purchased products, avoiding exceptions in order history and recent orders.

August 12, 2025

Storefront Compatibility Package v4.8.6, v4.7.9

The Storefront Compatibility Package has been updated to include the following changes:

• Fixed Cart API availability check: Resolved an issue where the Cart API incorrectly returned is_available: false for products that had sufficient inventory across Multiple Source Inventory (MSI) sources.
• Added uid field to Customer Address GraphQL query: Exposed the uid field in the Customer Address GraphQL query to enable setting shipping and billing addresses in negotiable quotes.

July 14, 2025

Storefront Compatibility Package v4.8.5, v4.7.8

The Storefront Compatibility Package has been updated to include the following changes:

• Miscellaneous bug fixes and enhancements related to cart item and order queries.

June 25, 2025

Storefront Compatibility Package v4.8.4, v4.7.6

The Storefront Compatibility Package has been updated to include the following changes:

• Added the Merge Cart Preference field to the Store > Sales > Checkout > Shopping Cart configuration panel in the Admin. It controls cart merge behavior when a GraphQL mutation merges guest or logged-in customer carts.
• Added the OrderTotal.grand_total_excl_tax field to the GraphQL order response to retrieve the grand total excluding tax.
• Introduced a new error code REQUIRED_PARAMETER_MISSING to handle missing configurable product options during the add-to-cart process via GraphQL.
• Added a new REST endpoint POST /V1/customers/:customerId/token to facilitate the social login feature through App Builder.
• (v4.7.6 only) Fixed an issue where plugins for GiftCardAccountManagementInterface methods were not working for webhooks.

May 29, 2025

Storefront Compatibility Package v4.8.3

The Storefront Compatibility Package has been updated to include the following changes:

• Added the exchangeExternalCustomerTokenmutation to facilitate social login feature through app builder.
• Fixed issue where plugins for GiftCardAccountManagementInterface methods were not working for webhooks.
• Fixed order search issue for guest shoppers in EDS.

May 26, 2025

Storefront Compatibility Package v4.8.2

The Storefront Compatibility Package has been updated to include the following changes:

• Added the customerSegments, customerGroup query.
• Exposed customer segment, customer group, cart rule related encoded information with customer and cart Query.

May 14, 2025

Storefront Compatibility Package v4.8.1

The Storefront Compatibility Package has been updated to include the following changes:

• Fixed issue where tax amounts were not updated when gift wrapping was removed from the cart using GraphQL.

May 27, 2025

Storefront Compatibility Package v4.8.0

The Storefront Compatibility Package has been updated to include the following changes:

• Added the clearWishlist mutation.
• Added enhanced support gift options to the cart, orders, and products queries.
• Miscellaneous bug fixes and enhancements.

July 3, 2025

Storefront Compatibility Package v4.7.7

The Storefront Compatibility Package has been updated to include the following changes:

• Miscellaneous bug fixes and enhancements.

June 2, 2025

Storefront Compatibility Package v4.7.5

The Storefront Compatibility Package has been updated to include the following changes:

• Added the exchangeExternalCustomerTokenmutation to facilitate social login feature through app builder.

May 26, 2025

Storefront Compatibility Package v4.7.4

The Storefront Compatibility Package has been updated to include the following changes:

• Added the customerSegments, and customerGroup queries.
• Exposed customer segment, customer group, cart rule related encoded information with customer and cart queries.
• Miscellaneous bug fixes and enhancements have been added for gift wrapping and related features.

April 28, 2025

Storefront Compatibility Package v4.7.3

The Storefront Compatibility Package has been updated to include the following changes:

• Removed exposure of customer group, customer segment, and cart price rule information through GraphQL.
• Fixed an Internal Server Error that occurred when selecting the second shipping method with a US address during checkout.

April 11, 2025

Storefront Compatibility Package v4.7.2

The Storefront Compatibility Package has been updated to include the following changes:

• Resolved a GraphQL issue where the quantity field in ProductInterface was not returning the saleable quantity.
• Fixed an issue where customer segment-based cart price rules didn’t apply immediately.

April 8, 2025

Storefront Compatibility Package v4.7.1

The Storefront Compatibility Package has been updated to include the following changes:

• Added the clearWishlist mutation.
• Added the customerGroup query.
• Added enhanced support gift options to the cart, orders, and products queries.
• Added fields to the storeConfig query to support checkout options, customer groups, catalog rules, and cart rules.
• Miscellaneous bugfixes and enhancements.