Next.js "Invalid next.config.js options detected" in CI
Next.js validates next.config against a schema on startup. A key that is misspelled, removed, or relocated between versions triggers "Invalid next.config.js options detected" and can fail strict builds.
What this error means
next build prints "Invalid next.config.js options detected:" with "Unrecognized key(s) in object: 'X'" or "Expected ..., received ...", naming the offending option.
next build
⚠ Invalid next.config.js options detected:
⚠ Unrecognized key(s) in object: 'target'
⚠ See more info here: https://nextjs.org/docs/messages/invalid-next-configCommon causes
A removed or renamed option for this Next version
Options like target were removed and others moved out of experimental; carrying them forward across an upgrade fails validation.
A typo in a config key
A misspelled key does not match the schema, so Next reports it as unrecognized.
How to fix it
Align the config with your Next version
- Read which key Next flagged as unrecognized.
- Check the upgrade guide for that version to see if the key moved or was removed.
- Rename, relocate, or delete the key and re-run the build.
next.config.js
// remove options no longer supported, e.g. 'target'
// move stabilized options out of experimental
module.exports = { /* validated keys only */ }Type-check the config
Annotate the config so an editor and tsc flag invalid keys before the build does.
next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = { /* ... */ }
module.exports = nextConfigHow to prevent it
- Follow the upgrade guide for config changes when bumping Next.
- Type-annotate next.config so invalid keys are caught early.
- Remove deprecated options instead of carrying them across versions.
Frequently asked questions
What causes ""Invalid next.config.js options detected""?
Options like target were removed and others moved out of experimental; carrying them forward across an upgrade fails validation.
How do I fix "Invalid next.config.js options detected"?
Align the config with your Next version
Related guides
Next.js "experimental.appDir" config removed after upgrade in CIFix Next.js builds failing on "experimental.appDir" in CI after upgrading to Next 13.4+ - the App Router is s…
Next.js "Failed to load next.config.js" ESM / require error in CIFix Next.js "Failed to load next.config.js" or "require() of ES Module" in CI - the config uses ESM syntax in…
Next.js ESLint errors failing next build in CIFix Next.js builds that fail because ESLint reported errors during next build in CI - Next runs lint on the p…