# 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   |                    |                    |
| 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.
:::