Storefront Compatibility Package

The Storefront Compatibility Package contains changes to the Adobe Commerce 2.4.7 codebase that enable drop-in component functionality.

Most of these changes enhance the Adobe Commerce GraphQL schema. However, miscellaneous bugfixes are also included. The drop-in components require this package.

Major features

The Storefront Compatibility Package defines the following queries and mutations:

clearWishlist mutation - Allows all items to be removed from a wishlist in a single action.
confirmCancelOrder mutation - Cancels the specified order for a guest.
confirmReturn mutation - Confirms a guest or customer return request.
estimateTotals mutation - Estimates totals for cart based on the address.
generateCustomerToken mutation - Creates a new customer token.
guestOrder query - Retrieves information about a guest order using an order number, email, and billing last name as input.
guestOrderByToken query - Retrieves information about a guest order based on an order token.
recaptchaFormConfig query - Returns information about the reCaptcha configuration for the specified form type.
requestGuestOrderCancel mutation - Cancels the specified guest order.
requestGuestReturn mutation - Requests a return for a specified order on behalf of a guest.
resendConfirmationEmail mutation - Resends a confirmation email to the specified customer upon request.

Release information

Latest version: 4.7.3

Release date: April 28, 2025

Version 4.7.3

Version 4.7.3 of the Storefront Compatibility Package includes 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.

Version 4.7.2

Version 4.7.2 of the Storefront Compatibility Package includes 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.

Version 4.7.1

Version 4.7.1 of the Storefront Compatibility Package includes 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.

Installation

Cloud infrastructure
On premises

Use this method to install the Storefront Compatibility Package using the Cloud infrastructure.

On your local workstation, change to the project directory for your Adobe Commerce on cloud infrastructure project.
Check out the environment branch to update using the Adobe Commerce Cloud CLI.
Terminal window
```
magento-cloud environment:checkout <environment-id>
```

Add the Storefront Compatibility module.

composer require adobe-commerce/storefront-compatibility

Update package dependencies.

composer update "adobe-commerce/storefront-compatibility"

Commit and push code changes for the composer.json and composer.lock files.
Add, commit, and push the code changes for the composer.json and composer.lock files to the cloud environment
Terminal window
```
git add -A
git commit -m "Add module"
git push origin <branch-name>
```
Pushing the updates to the cloud environment initiates the Commerce cloud deployment process to apply the changes. Check the deployment status from the deploy log.

Use this method to install the Storefront Compatibility Package for an on-premises instance.

Use Composer to add the package module to your project:
Terminal window
```
composer require adobe-commerce/storefront-compatibility
```
Upgrade Adobe Commerce:
Terminal window
```
bin/magento setup:upgrade
```

Update the package

Use the following procedure to update patch versions of the Storefront Compatibility Package.

Run the following command to update the package:
Terminal window
```
composer update adobe-commerce/storefront-compatibility
```
Run the following commands to upgrade Adobe Commerce and clear the cache.
Terminal window
```
bin/magento setup:upgrade && bin/magento cache:clean
```