Fix Library ? Netlify + Next.js
Netlify + Next.js troubleshooting

Fix Netlify Next.js Plugin Missing or Not Detected

Netlify needs the correct Next.js runtime behavior for SSR, image routes, and API routes. Check plugin/runtime detection and publish settings.

Book $50 Deploy RescueGenerate a checklist

Common symptoms

  • Static assets deploy but SSR routes fail.
  • API routes 404 on Netlify.
  • Logs mention Next.js runtime or plugin issues.

What to check first

Platform: Netlify + Next.js
Error: Next.js plugin missing

Netlify needs the correct Next.js runtime behavior for SSR, image routes, and API routes. Check plugin/runtime detection and publish settings.

Step-by-step fix

  1. Use the current Netlify Next.js runtime instead of old plugin snippets.
  2. Check package versions for Next.js and Netlify runtime compatibility.
  3. Set build command to npm run build and publish directory to .next only when documented for your setup.
  4. Redeploy after clearing cache.
# netlify.toml
[build]
  command = "npm run build"

Common mistake to avoid

Do not copy old @netlify/plugin-nextjs examples without checking current Netlify docs.

Still stuck?

Send the deploy log, repository link, target platform, and expected URL. ShipFast Deploy Rescue is a fixed-price debugging service for indie projects and MVPs.

Get Deploy RescueEmail project details