This page is also available as Markdown: request this page's URL with an Accept: text/markdown header. For an index of Next.js documentation, see /docs/llms.txt.

distDir

Last updated June 16, 2025

You can specify a name to use for a custom build directory to use instead of .next.

Open next.config.js and add the distDir config:

next.config.js

module.exports = {
  distDir: 'build',
}

Now if you run next build Next.js will use build instead of the default .next folder.

distDir should not leave your project directory. For example, ../build is an invalid directory.