Upgrading

Latest version

To update to the latest version of Next.js, you can use the upgrade command:

pnpm next upgrade

Versions before Next.js 16.1.0 do not support the upgrade command and need to use a separate package instead:

npx @next/codemod@canary upgrade latest

To have a coding agent perform and verify the upgrade, run:

npx next@canary upgrade --agent=latest

See Upgrade with a coding agent for other policies and upgrade reminders.

If you prefer to upgrade manually, install the latest Next.js and React versions:

pnpm i next@latest react@latest react-dom@latest eslint-config-next@latest

Canary version

To update to the latest canary, make sure you're on the latest version of Next.js and everything is working as expected. Then, run the following command:

pnpm add next@canary

Features available in canary

The following features are currently available in canary:

Authentication:

• forbidden
• unauthorized
• forbidden.js
• unauthorized.js
• authInterrupts

Version guides

See the version guides for in-depth upgrade instructions.

Last updated October 6, 2026