gatsbyjs/gatsby · error

Your site is doing more work than it needs to for Preview, u

Error message

Your site is doing more work than it needs to for Preview, upgrade to Gatsby ^${GATSBY_VERSION_MANIFEST_V2} for better performance

What it means

In contentfulCreateNodeManifest (Preview/Content Sync path), this fires once when the site is using a Gatsby version that lacks efficient native node-manifest support, forcing the plugin to do extra per-node work. It is purely a performance advisory: manifests still work, but upgrading Gatsby to GATSBY_VERSION_MANIFEST_V2 or newer reduces redundant work during Preview sourcing.

Source

Thrown at packages/gatsby-source-contentful/src/normalize.js:338

    process.env.CONTENTFUL_DEBUG_NODE_MANIFEST === `true` &&
    numberOfContentSyncDebugLogs <= maxContentSyncDebugLogTimes
  ) {
    numberOfContentSyncDebugLogs++

    console.info(
      JSON.stringify({
        isPreview,
        createNodeManifestIsSupported,
        shouldCreateNodeManifest,
        manifestId,
        entryItemSysUpdatedAt: updatedAt,
      })
    )
  }

  if (shouldCreateNodeManifest) {
    if (shouldUpgradeGatsbyVersion && !warnOnceToUpgradeGatsby) {
      console.warn(
        `Your site is doing more work than it needs to for Preview, upgrade to Gatsby ^${GATSBY_VERSION_MANIFEST_V2} for better performance`
      )
      warnOnceToUpgradeGatsby = true
    }

    unstable_createNodeManifest({
      manifestId,
      node: entryNode,
      updatedAtUTC: updatedAt,
    })
  } else if (
    isPreview &&
    !createNodeManifestIsSupported &&
    !warnOnceForNoSupport
  ) {
    console.warn(
      `Contentful: Your version of Gatsby core doesn't support Content Sync (via the unstable_createNodeManifest action). Please upgrade to the latest version to use Content Sync in your site.`
    )

View on GitHub (pinned to e85d62f177)

Solutions

1. Upgrade gatsby (and gatsby-cli) to ^GATSBY_VERSION_MANIFEST_V2 or newer in package.json.
2. If upgrading immediately is not possible, ignore the warning — Preview still functions, just slower.
3. Run npm ls gatsby to confirm no duplicate/older gatsby version is resolved in the workspace.

When it happens

Trigger: Thrown at packages/gatsby-source-contentful/src/normalize.js:338 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/6c8a578d21fc8572. Report an issue: GitHub.