gatsbyjs/gatsby · error

Contentful: Your version of Gatsby core doesn't support Cont

Error message

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.

What it means

Error "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." thrown in gatsbyjs/gatsby.

Source

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

  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.`
    )
    warnOnceForNoSupport = true
  }
}

function makeQueuedCreateNode({ nodeCount, createNode }) {
  if (nodeCount > 5000) {
    let createdNodeCount = 0

    const createNodesQueue = fastq((node, cb) => {
      function runCreateNode() {
        const maybeNodePromise = createNode(node)

        // checking for `.then` is vastly more performant than using `instanceof Promise`
        if (`then` in maybeNodePromise) {
          maybeNodePromise.then(() => {
            cb(null)

View on GitHub (pinned to e85d62f177)

Solutions

1. Upgrade gatsby core to a version that implements unstable_createNodeManifest.
2. If Content Sync is not needed, ignore the warning; regular sourceNodes behavior is unaffected.
3. Verify that no stale gatsby version is hoisted in node_modules causing the action to be missing.

When it happens

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