Supported Node.js versions

Learn about the supported Node.js versions on Vercel.
Table of Contents

By default, a new project uses the latest Node.js LTS version available on Vercel.

Current available versions are:

  • 20.x (default)
  • 18.x (retiring early 2025)
  • 16.x (deprecated, retiring January 31st, 2025)

Only major versions are available. Vercel automatically rolls out minor and patch updates when needed, such as to fix a security issue.

To override the default version and set a different Node.js version for all new projects:

  1. From your dashboard, select your project.
  2. Select the Settings tab.
  3. On the General page, navigate to the Node.js Version section.
  4. Select the version you want to use from the dropdown. This Node.js version will be used for all new deployments.
First, select your Node.js version in Project Settings.
First, select your Node.js version in Project Settings.

You can define the major Node.js version in the engines#node section of the package.json to override the one you have selected in the Project Settings:

package.json
{
  "engines": {
    "node": "20.x"
  }
}

For instance, when you set the Node.js version to 18.x in the Project Settings and you specify a valid semver range for Node.js 20 (e.g. 20.x) in package.json, your project will be deployed with the latest 20.x version of Node.js.

The following table lists some example version ranges and the available Node.js version they map to:

Version in package.jsonVersion deployed
20.x
^20.0.0
>=20.0.0
>=18.0.0
>=16.0.0
latest 20.x version
18.x
^18.0.0
latest 18.x version
16.x
^16.0.0
latest 16.x version

To verify the Node.js version your Deployment is using, either run node -v in the Build Command or log process.version.

Last updated on July 16, 2024