gatsbyjs/gatsby · error

80001

80001

Error message

Failed to restore previous client module manifest.\n\nThis can happen if the manifest is corrupted or is not compatible with the current version of Gatsby.\n\nPlease run "gatsby clean" and try again. If the issue persists, please open an issue with a reproduction at https://gatsby.dev/new-issue for more help.

What it means

Error "Failed to restore previous client module manifest.\n\nThis can happen if the manifest is corrupted or is not compatible with the current version of Gatsby.\n\nPlease run "gatsby clean" and try again. If the issue persists, please open an issue with a reproduction at https://gatsby.dev/new-issue for more help." thrown in gatsbyjs/gatsby.

Source

Thrown at packages/gatsby/src/utils/webpack/plugins/partial-hydration.ts:374

      }
    })
  }

  apply(compiler: webpack.Compiler): void {
    // Restore manifest from the previous compilation, otherwise it will be wiped since files aren't visited on cached builds
    compiler.hooks.beforeCompile.tap(this.name, () => {
      try {
        const previousManifest = fs.existsSync(this._manifestPath)

        if (!previousManifest) {
          return
        }

        this._previousManifest = JSON.parse(
          fs.readFileSync(this._manifestPath, `utf-8`)
        )
      } catch (error) {
        this._reporter.panic({
          id: `80001`,
          context: {},
          error,
        })
      }
    })

    compiler.hooks.finishMake.tapPromise(this.name, async compilation => {
      if (compilation.compiler.parentCompilation) {
        // child compilation happen for css modules for example, we only care about the main compilation
        return
      }
      await this.addClientModuleEntries(compiler, compilation)
    })

    compiler.hooks.thisCompilation.tap(
      this.name,
      (compilation, { normalModuleFactory }) => {

View on GitHub (pinned to e85d62f177)

Solutions

1. Run `gatsby clean` to remove the corrupted client module manifest
2. If it persists, open an issue with a reproduction at https://gatsby.dev/new-issue

When it happens

Trigger: Thrown at packages/gatsby/src/utils/webpack/plugins/partial-hydration.ts:374 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of gatsbyjs/gatsby@e85d62f177 (2026-08-26). Data as JSON: /api/errors/10bf375027a21d8c. Report an issue: GitHub.