---
schema_version: "1"
id: 09a1c80143c7eb107bcdb7478231e6c2b81d9d342e7e7f5fab5f3b4467e94496
title: PWA Compatibility Matrix
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/pwa-kit-managed-runtime/guides/compatibility-matrix.md
canonical_url: https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/compatibility-matrix.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 69a025cf0d03a86e1c7ca6f5df5cef983e422948b7f19577a80f5441087418db
products:
  - Composable Storefront
  - Salesforce APIs
---
# 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](https://github.com/SalesforceCommerceCloud/pwa-kit/tree/develop/packages/template-retail-react-app) and [commerce-sdk-react](https://github.com/SalesforceCommerceCloud/pwa-kit/tree/develop/packages/commerce-sdk-react).

In addition, depending on your project's build, your storefront may have additional dependencies on the [commerce-sdk-isomorphic](https://github.com/SalesforceCommerceCloud/commerce-sdk-isomorphic) package or the [plugin_slas](https://github.com/SalesforceCommerceCloud/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 Kit**     | **retail-react-app** | **commerce-sdk-react** | **commerce-sdk-isomorphic** | **plugin_slas** | Notable Changes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| :-----------------: | :------------------: | :--------------------: | :-------------------------: | :-------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|     **v3.10.x**     |        v6.1.x        |     v3.3 or later      |        v3.3 or later        |      v7.4       | **Retail react app**<br/><ul><li>Source maps support for both client and server on Managed Runtime. See [Debug Using Source Maps](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/debugging.md#debug-using-source-maps).</li><li>Data Cloud integration with PWA Kit events.</li><li>Page meta data tags from Business Manager now supported on Product Detail Pages (PDP) and Product List Pages (PLP).</li><li>Improved password management with Confirm New Password field in Reset & Change Password flows.</li><li>Enhanced performance logging for server-timing headers.</li><li>Fixed `hreflang` alternate links and accessibility issues.</li></ul>**Commerce-sdk-react**<ul><li>Fixed guest login token handling with hybrid authentication.</li><li>Improved cache management during logout.</li><li>Added support for custom parameters in SLAS authorization calls.</li>See [v3.10.0 (retail-react-app@6.1.0 and commerce-sdk-react@3.3.0)](https://github.com/SalesforceCommerceCloud/pwa-kit/releases/tag/v3.10.0) on GitHub. |
|     **v3.9.x**      |         v6.x         |     v3.2 or later      |        v3.2 or later        |      v7.4       | **Retail react app**<br/><ul><li>Passwordless and social login support.</li><li>Password reset support.</li><li>Do not track support.</ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|     **v3.8.x**      |         v5.x         |     v3.1 or later      |        v3.1 or later        |      v7.4       | **Retail react app**<ul><li>Shopper context integration</li><li>Active data tracking set to `true` by default.</li></ul><br/>**Commerce-sdk-react**<br/><ul><li>Attach dwsid to SCAPI requests</li><li>Remove OCAPI session bridging.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|     **v3.7.x**      |         v4.x         |          v3.x          |            v3.x             |      v7.3       | **Commerce-sdk-react**<ul><li>SLAS now requires `channel_id`.</li><li>Shopper context now requires `siteId`.</li><li>Upgrade to commerce-sdk-isomorphic v3.x</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|     **v3.6.x**      |         v3.x         |          v2.x          |            v2.x             |      v7.3       | **Retail react app**<br/><ul><li>Product tile rework.</li></ul><br/>**Commerce-sdk-react**<ul><li>Upgrade to commerce-sdk-isomorphic v2.x</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|     **v3.5.x**      |         v2.x         |     v1.4.0 < v2.x      |            v1.10            |      v7.3       | **Commerce-sdk-react**<ul><li>SLAS private client support.</li><li>Reworks how sessions are transferred between SFRA and PWA so OCAPI /sessions call is not required on the PWA</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **v3.1.1 - v3.4.x** |         v2.x         |    v1.0.2 < v1.4.0     |            v1.10            |   v7.0 - v7.2   | **Retail react app**<ul><li>Page designer types migrated to commerce-sdk-react</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **v3.0.0 - v3.1.0** |         v1.x         |    v1.0.0 - v1.0.1     |            v1.10            |   v7.0 - v7.2   | Initial 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](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/references/about-pwa-kit-managed-runtime/about.html).

**note:** 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](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/upgrade-to-v3.md#optional-consume-the-commerce-sdk-react-hooks-library) for more information
