npm / @netlify/plugin-nextjs
@netlify/plugin-nextjs
What changed in @netlify/plugin-nextjs 4 to 5, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-20.
1 breaking2 performance1 behavior and defaults19 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@netlify/plugin-nextjs 521 changes
Breaking changes 1
Pages router no longer prefetches the revalidation marker.
Performance 2
Indexes revalidated tags so requests no longer read one manifest per tag.
HTMLRewriter WASM is lazy-loaded only when needed.
Behavior and default changes 1
Adds header handling for static service-worker assets.
Fixes and other changes 17
App router tags are encoded when purging cache.
Seeds the route group cache correctly for the new cache key signature.
Adjusts cache handler keys for compatibility with next@16.3.8.
Preserves initURL.
Awaits the Node middleware require in the generated edge handler template.
Keeps non-ASCII blob keys consistent between build and runtime.
Prevents crashes when server actions exceed the body size limit.
Handles invalid _next/image requests.
Prerendered content is marked as less stale now that the expire setting is enforced when marking content for blocking re-render.
Fixed matching on data routes when the middleware matcher uses allowed paths.
A cache tag is now set for getStaticProps redirects.
Same-url rewrites are no longer optimized when response headers need to be applied.
Handles extractExportedConstValue returning null or a wrapped object in next@canary.
Works around tarball bundling issues with virtual CJS modules for Node.js middleware/proxy.
Fixes resolving CommonJS when a nested package.json is present in Node Middleware/proxy.
Cache tags provided by Next.js for the App Router are now encoded.
Handles Next.js using cdn-cache-control for cacheable responses.
@netlify/plugin-nextjs 42 changes
Fixes and other changes 2
fetch is reassignable instead of const, fixing cases where reassignment is needed.
self is reassignable instead of const, fixing cases where reassignment is needed.