Skip to content
DocsErrorsMinimum React Version

Minimum React Version

Why This Error Occurred

Your project is using an old version of react or react-dom that does not meet the suggested minimum version requirement.

Next.js suggests using, at a minimum, react@18.2.0 and react-dom@18.2.0. Older versions of react and react-dom do work with Next.js, however, they do not enable all of Next.js' features.

For example, the following features are not enabled with old React versions:

  • Fast Refresh: instantly view edits to your app without losing component state
  • Component stack trace in development: see the component tree that lead up to an error
  • Hydration mismatch warnings: trace down discrepancies in your React tree that cause performance problems

This list is not exhaustive, but illustrative in the value of upgrading React!

Possible Ways to Fix It

Via npm

Terminal
npm upgrade react@latest react-dom@latest

Via Yarn

Terminal
yarn add react@latest react-dom@latest

Manually Open your package.json and upgrade react and react-dom:

package.json
{
  "dependencies": {
    "react": "^18.2.0",
    "react-dom": "^18.2.0"
  }
}