Supported Node.js versions
Learn about the supported Node.js versions on Vercel.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:
- From your dashboard, select your project.
- Select the Settings tab.
- On the General page, navigate to the Node.js Version section.
- Select the version you want to use from the dropdown. This Node.js version will be used for all new deployments.
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:
{
"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.json | Version 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
.
Was this helpful?