PWA Compatibility Matrix

With the release of Progressive Web App (PWA) Kit version 3.0, we introduced two new independently versioned packages to the platform, retail-react-app and commerce-sdk-react.

In addition, depending on your project’s build, your storefront may have additional dependencies on the commerce-sdk-isomorphic package or the plugin_slas Storefront Reference Architecture (SFRA) cartridge.

Check this table to make sure you’re using compatible versions of PWA Kit, retail-react-app, commerce-sdk-react, commerce-sdk-isomorphic, and plugin_slas.

PWA Kitretail-react-appcommerce-sdk-reactcommerce-sdk-isomorphicplugin_slasNotable Changes
v3.10.xv6.1.xv3.3 or laterv3.3 or laterv7.4Retail react app
  • Source maps support for both client and server on Managed Runtime. See Debug Using Source Maps.
  • Data Cloud integration with PWA Kit events.
  • Page meta data tags from Business Manager now supported on Product Detail Pages (PDP) and Product List Pages (PLP).
  • Improved password management with Confirm New Password field in Reset & Change Password flows.
  • Enhanced performance logging for server-timing headers.
  • Fixed hreflang alternate links and accessibility issues.
Commerce-sdk-react
v3.9.xv6.xv3.2 or laterv3.2 or laterv7.4Retail react app
  • Passwordless and social login support.
  • Password reset support.
  • Do not track support.
v3.8.xv5.xv3.1 or laterv3.1 or laterv7.4Retail react app
  • Shopper context integration
  • Active data tracking set to true by default.

Commerce-sdk-react
  • Attach dwsid to SCAPI requests
  • Remove OCAPI session bridging.
v3.7.xv4.xv3.xv3.xv7.3Commerce-sdk-react
  • SLAS now requires channel_id.
  • Shopper context now requires siteId.
  • Upgrade to commerce-sdk-isomorphic v3.x
v3.6.xv3.xv2.xv2.xv7.3Retail react app
  • Product tile rework.

Commerce-sdk-react
  • Upgrade to commerce-sdk-isomorphic v2.x
v3.5.xv2.xv1.4.0 < v2.xv1.10v7.3Commerce-sdk-react
  • SLAS private client support.
  • Reworks how sessions are transferred between SFRA and PWA so OCAPI /sessions call is not required on the PWA
v3.1.1 - v3.4.xv2.xv1.0.2 < v1.4.0v1.10v7.0 - v7.2Retail react app
  • Page designer types migrated to commerce-sdk-react
v3.0.0 - v3.1.0v1.xv1.0.0 - v1.0.1v1.10v7.0 - v7.2Initial release of PWA Kit 3.x

For more information about the features available in various versions of PWA Kit and retail-react-app, see the Composable Storefront Release Notes.

Projects on PWA Kit v2 are not compatible with retail-react-app.

Projects on PWA Kit v2 may consume commerce-sdk-react as a customization. See the Upgrade to v3 guide for more information

Note

Node 20 Deprecation

Node 20 has an end-of-life date of April 30, 2026. We strongly recommend that you update your production projects to Node 22 or Node 24 by upgrading to the latest minor version of PWA Kit 3.x. See full details on Node support dates and upgrade steps in Upgrade Node Version.

Announcements
Choose Your B2C Commerce Storefront Type
B2C Commerce
SCAPI
Storefront Next
Composable Storefront
Composable Storefront Overview
Quick Start
Deploy Your Code
Skills for Success
Introduction to Composable Storefront
Best Practices Checklist
Headless Commerce with Salesforce Commerce API
PWA Kit Overview
Managed Runtime Overview
Managed Runtime API
PWA Kit Compatibility Matrix
Use Composable Storefront in a Hybrid Implementation
PWA Kit Framework
Performance Guide for Composable Storefronts
Get Set Up
Build Your Site
Enable Your Merchant Team
Test, Launch, and Monitor
Maintain
Composable Storefront Specifications
Storefront Reference Architecture (SFRA)
Commerce Apps ISV Developer Guide
B2C Commerce Solutions
B2C Commerce Release Notes
B2C Commerce Reference Information
Ask the Community