npm WARN EBADENGINE Unsupported engine / The engine "node" is incompatible with this module
A package requires a different Node.js version than the one you’re running.
Exact message you may see
Unsupported engineThe engine "node" is incompatible with this module
Seen on:
Node.js
Meaning
package.json "engines" declares supported versions. npm warns (EBADENGINE); yarn and pnpm can fail. Running anyway may break at runtime.
Common causes
- Node too old for a dependency
- Node too new for a legacy package
- CI using a different Node version than local
⚡ Quick fix
- Switch Node version with nvm (nvm use 20)
- Add .nvmrc to the project
- Pin Node in CI (setup-node)
Detailed fix by platform
Node.js
echo "20" > .nvmrc && nvm use
How to diagnose
- Required — Version range in the message
- Current — node -v
🔧 Still not fixed?
Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:
Similar errors
Most viewed in Node.js
Other ways to find it
Where this error sits
Origin: Application & API. Errors that are often confused with or caused by this one (click to open):
🧠 Still stuck? Analyze your error
Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.
💬 What worked for others
No tips yet — did something else fix this for you?
Share what worked for you
Tips are checked by an editor before they appear. Links are removed.
Did this fix work for you?
Report a correction or suggest an improvement
Last updated 13 Oct 2026