Modernize Next.js
Operational guides for upgrading Next.js: the Next.js 15 upgrade hub, version-to-version paths, Pages Router to App Router migration, and build-error recovery.
Last verified · Updated May 22, 2026
Next.js major versions ship real breaking changes — async request APIs, changed caching defaults, and the App Router model. This hub links every supported upgrade path plus the workflows for the build errors those upgrades surface.
What this covers
Start at the Next.js 15 upgrade hub for the full breaking-change picture, then pick the source-to-target page that matches the version you are on today. For a routing model change, see the Pages Router to App Router guide. Each page includes a repo-inspection prompt, step-by-step migration, a test plan, and rollback guidance.
Version timeline
- 15.xcurrentactivereleased 2024-10-21
- 14.xmaintenancereleased 2023-10-26
- 13.xmaintenancereleased 2022-10-25
Next.js migration paths
- Next.js 13 to Next.js 15 Migration Guidehigh riskVersion path
- Next.js 14 to Next.js 15 Migration Guidemedium riskVersion path
- Migrate Next.js Pages Router to App Routerhigh riskMigration
- Upgrade to Next.js 15medium riskUpgrade hub
- Upgrade to Next.js 15medium riskVersion path
- Fix Next.js Build Errorsmedium riskWorkflow
Frequently asked questions
Which Next.js version should I target?
Next.js 15 is the current stable release. If you are on 13 or 14, the mechanical work is similar — the biggest changes are the now-async request APIs and the caching defaults, both covered by the official @next/codemod upgrade CLI.