Node.js 18.17 or newer is required
Action requiredOlder Node.js runtimes are unsupported.
Migration
Update local, CI and hosting runtimes before building.
Official sources
Next.js Upgrade Guide
Compare Next.js versions and see exactly what changes, what requires action, and what you can start using.
→
4Changes
4Breaking
4Actions
0Features
0Migration tools
Analyze your project
Local only Check your package.json
UpgradePath detects relevant tools and selects them automatically.
Analyzed locally in your browser. Nothing is uploaded.
Project setup
What does your project use?
Select the tools in your project to include relevant dependency updates in this guide.
Breaking Changes
next export is removed
Action requiredStatic export is configured through output.
// build: next build && next export
module.exports = {};// build: next build
module.exports = {
output: 'export',
}; Migration
Set output: 'export' in next.config.js and run next build. Check dynamic routes and server-only features.
Official sources
@next/font is removed
Action requiredUse the built-in font module.
import { Roboto } from '@next/font/google';
const font = Roboto({ weight: '400', subsets: ['latin'] });import { Roboto } from 'next/font/google';
const font = Roboto({ weight: '400', subsets: ['latin'] }); Migration
Replace @next/font imports with next/font; run npx @next/codemod@latest built-in-next-font .
Official sources
ImageResponse moves to next/og
Action requiredThe next/server import is replaced.
import { ImageResponse } from 'next/server';
export async function GET() {
return new ImageResponse(<div>UpgradePath</div>);
}import { ImageResponse } from 'next/og';
export async function GET() {
return new ImageResponse(<div>UpgradePath</div>);
} Migration
Import ImageResponse from next/og and verify generated social images.
Official sources