
Essential Next.js Build Plugin (beta)
:warning: This is the beta version of the Essential Next.js plugin. For the stable version, see Essential Next.js plugin v3 :warning:
What's new in this version
Version 4 is a complete rewrite of the Essential Next.js plugin. For full details of everything that's new, see the v4 release notes
Installing the beta
npm install -D @netlify/plugin-nextjs@beta
- Change the
publish
directory to .next
and add the plugin to netlify.toml
if not already installed:
[build]
publish = ".next"
[[plugins]]
package = "@netlify/plugin-nextjs"
If you previously set target: "serverless"
or a custom distDir
in your next.config.js
, or set node_bundler
or external_node_modules
in your netlify.toml
these are no longer needed and can be removed.
The serverless
and experimental-serverless-trace
targets are deprecated in Next 12, and all builds with this plugin will now use the default server
target.
If you are using a monorepo you will need to change publish
to point to the full path to the built .next
directory, which may be in a subdirectory. If you have changed your distDir
then it will need to match that.
If you are using Nx, then you will need to point publish
to the folder inside dist
, e.g. dist/apps/myapp/.next
.
Beta feedback
Please share any thoughts, feedback or questions about the beta in our discussion.