---
schema_version: "1"
id: 046279aee1688e4d3a232b27d7753ec1e6cb93779c465f94afea077c560dd555
title: Upgrade Node Version
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/pwa-kit-managed-runtime/guides/upgrade-node-version.md
canonical_url: https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/upgrade-node-version.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: a642cff60437f0f428d039174a11c0db1fab96bb28dcc3ea7906238552291d58
products:
  - Composable Storefront
  - Salesforce APIs
---
# Upgrade Node Version

**important:** You _must_ upgrade to Node.js 20 or higher, or you will _not_ be able to deploy your site. For more information, see the table below.

Customers control which version of Node.js is used to run a Managed Runtime environment. Every two years, customers must upgrade Node.js versions, as support for older versions is removed to maintain security.

## Supported Node Versions

**Support date definitions**

- **End of Life**: Customers will no longer be able to deploy bundles using this version of Node.js after this date.
- **Deprecation**: Customers will start seeing a warning that a Node.js version upgrade will be required in the future for uninterrupted deployments.
- **Availability**: When this version of Node.js was first supported.

**The current recommended version is Node.js 24.**

| Version | Availability date  | Deprecation date   | End of Life date   |
| ------- | ------------------ | ------------------ | ------------------ |
| 24.x    | March 12, 2026     |                    |                    |
| 22.x    | January 31, 2025   | October 1, 2026    | June 1, 2027       |
| 20.x    | January 19, 2024   | August 21, 2025    | April 30, 2026     |
| 18.x    | June 21, 2023      | January 31, 2025   | September 1, 2025  |
| 16.x    | March 3, 2023      | June 21, 2023      | September 13, 2023 |
| 14.x    | September 18, 2021 | April 30, 2023     | September 13, 2023 |
| 12.x    | September 18, 2021 | September 20, 2022 | November 14, 2022  |

## Upgrade Steps

To update an environment to the latest supported version of Node.js:

- Edit your project’s `package.json` file.
- Upgrade your project to [the latest minor version of PWA Kit 2.x or 3.x](https://github.com/SalesforceCommerceCloud/pwa-kit/releases).
- Update `ssrParameters.ssrFunctionNodeVersion` to the latest supported version of Node.js. _This attribute sets the version of Node.js used by Managed Runtime environments._
- Update your local development environments, continuous integration servers, and anything that builds bundles to use the latest supported version of Node.js. _Reinstall all of your project's packages using the new Node.js version._
- Test that your project works as expected in a local development environment.
- Push a new bundle and deploy it to a non-production environment.
- Confirm that the environment works as expected.
- Deploy the new bundle to your production environment.

## Opt Out of Email Notifications

By default, project teams receive automated email notifications when their environments are using deprecated or end-of-life Node.js versions. These notifications help ensure timely upgrades and avoid deployment disruptions.

To opt out of these notifications:

1. Log into [Runtime Admin](https://runtime.commercecloud.com) and then click **Account Settings**.
2. In the **Email Notifications** section, deselect the notification you want to opt out of.

**note:** We recommend keeping these notifications enabled to ensure your team stays informed about required Node.js upgrades. Opting out may result in unexpected deployment failures when Node.js versions reach end of life.