Manual installation

On Commerce on Cloud or on-premises with Adobe Commerce Optimizer, install the B2C Storefront Compatibility Package with Composer on your Commerce server. If you use B2B drop-ins, also install the Storefront Compatibility B2B Package (SCP-B2B) on the same instance after the B2C package. Not sure this is your path? See Find your path.

Choose your B2C package

The package version must match your Adobe Commerce release. Use the version from this table in composer require adobe-commerce/storefront-compatibility:VERSION.

Adobe Commerce	Package version	Reference
2.4.9 (recommended)	4.9.3	GraphQL and REST changes
2.4.8	4.8.28	GraphQL and REST changes
2.4.7	4.7.15	GraphQL and REST changes

Composer key requirements

To access the latest Storefront Compatibility Package, you must have either an Adobe Commerce Optimizer license for Commerce on Cloud or on-premises, or an Adobe Commerce as a Cloud Service license. Adobe Commerce on Cloud or on-premises without Optimizer is not supported. Magento Open Source instances are not supported.

Install the B2C package

Commerce on Cloud

1. Change to your Commerce project directory.

2. Check out the environment branch you want to update.

   magento-cloud environment:checkout <environment-id>

3. Add the package using the version from Choose your B2C package.

   composer require adobe-commerce/storefront-compatibility:4.9.3

   Use 4.8.28 for Adobe Commerce 2.4.8.

   Use 4.7.15 for Adobe Commerce 2.4.7.

4. Update package dependencies.

   composer update adobe-commerce/storefront-compatibility

5. Commit and push so the cloud environment picks up composer.json and composer.lock.

   git add composer.json composer.lock
   git commit -m "Add module"
   git push origin <branch-name>

   To confirm the deployment succeeded, check the Deploy log in the Cloud console when the push finishes.

On-premises

1. Add the package using the version from Choose your B2C package.

   composer require adobe-commerce/storefront-compatibility:4.9.3

   Use 4.8.28 for Adobe Commerce 2.4.8.

   Use 4.7.15 for Adobe Commerce 2.4.7.

2. Apply the module and clear the cache.

   bin/magento setup:upgrade && bin/magento cache:clean

Choose your B2B package

B2B drop-ins need SCP-B2B in addition to the B2C package. Adobe Commerce B2B must already be configured on your Commerce instance. SCP-B2B supports Adobe Commerce 2.4.8 and 2.4.9 only, not Adobe Commerce 2.4.7.

Use the version from this table in composer require adobe-commerce/storefront-compatibility-b2b:VERSION. For GraphQL changes in the package, see B2B Compatibility Package.

Adobe Commerce	Package version
2.4.9 (recommended)	1.0.25
2.4.8	1.0.25

Composer key requirements

To access the latest Storefront Compatibility B2B Package, you must have either an Adobe Commerce Optimizer license for Commerce on Cloud or on-premises, or an Adobe Commerce as a Cloud Service license — the same requirement as the Storefront Compatibility Package (B2C). PaaS-only and Magento Open Source instances are not supported.

Install the B2B package

Install SCP-B2B only after the B2C Storefront Compatibility Package is on the instance.

Commerce on Cloud

1. Change to your Commerce project directory.

2. Check out the environment branch you want to update, if you have not already done so for the B2C package.

3. Add SCP-B2B using the version from Choose your B2B package.

   composer require adobe-commerce/storefront-compatibility-b2b:1.0.25

4. Update package dependencies.

   composer update adobe-commerce/storefront-compatibility-b2b

5. Commit and push so the cloud environment picks up composer.json and composer.lock.

   git add composer.json composer.lock
   git commit -m "Add B2B compatibility package"
   git push origin <branch-name>

On-premises

1. Add SCP-B2B using the version from Choose your B2B package.

   composer require adobe-commerce/storefront-compatibility-b2b:1.0.25

2. Apply the module and clear the cache.

   bin/magento setup:upgrade && bin/magento cache:clean

Update the packages

Use these steps after your initial Composer install to move to a newer patch version. Open the changelog and filter for the Storefront Compatibility Package or Storefront Compatibility B2B Package before you update.

1. Update the B2C package:

   composer update adobe-commerce/storefront-compatibility

2. If you use B2B drop-ins, update the SCP-B2B package:

   composer update adobe-commerce/storefront-compatibility-b2b

3. Upgrade Commerce and clear the cache:

   bin/magento setup:upgrade && bin/magento cache:clean

What’s next

After you install the packages, configure your storefront to connect to Commerce. Confirm any remaining items on the Commerce on Cloud or on-premises checklist before going live.