Supported Node.js Versions
Warning: Support for Node.js version 18 is discontinued for Launch as of August 1, 2025. Update to a supported Node.js version to avoid disruptions in your projects.
The following are the available Node.js versions on Launch:
- 22.x (default)
- 20.x
- 18.x (discontinued as of August 1, 2025)
- Only major long-term support (LTS) versions are supported. Contentstack Launch will automatically update to the latest minor versions and security patches.
- If your site uses an unsupported version of Node.js, update it before redeploying. Launch does not automatically upgrade Node.js for existing deployments. Deployments are blocked until a supported version is specified.
Setting the Node.js Version in the package.json File
You can specify the major Node.js version in the engines#node section of the package.json file.
Example:
package.json
{
"engines": {
"node": "20.x"
}
}
When a valid semver range for Node.js 20 (e.g. 20.x) is specified in the package.json, the project will be deployed with the latest available 20.x version of Node.js.
Note: If the engines#node section is not specified in package.json, the default Node.js version (Node.js 22.x) will be used.
Example Version Ranges and their Deployed Node.js Versions:
Version in package.json | Version deployed |
---|---|
20.x | 20.x |
^20.0.0 | 20.x |
>=20.0.0 | 22.x |
>=18.x | 22.x |
18.x | 18.x |
^18.0.0 | 18.x |