gatsbyjs/gatsby · error

${e.message}

Error message

${e.message}

What it means

Fallback branch of areRemotePluginVersionsSatisfied: the wpGatsbyCompatibility query failed with an error that is not the 'field does not exist' signature of an old WPGatsby. The raw error message is panicked directly — connectivity problems, auth failures, or a fatal WPGraphQL error on the site.

Source

Thrown at packages/gatsby-source-wordpress/src/steps/check-plugin-requirements.ts:107

      throwGqlErrors: true,
      isFirstRequest: true,
    })

    wpgqlIsSatisfied = data.wpGatsbyCompatibility.satisfies.wpGQL
    wpGatsbyIsSatisfied = data.wpGatsbyCompatibility.satisfies.wpGatsby
  } catch (e) {
    if (
      e.message.includes(
        `Cannot query field "wpGatsbyCompatibility" on type "RootQuery".`
      )
    ) {
      helpers.reporter.panic(
        formatLogMessage(
          `Your version of WPGatsby is too old to determine if we're compatible.${genericDownloadMessage}`
        )
      )
    } else {
      helpers.reporter.panic(e.message)
    }
  }

  const shouldDisplayWPGraphQLReason =
    !wpgqlIsSatisfied && supportedWpPluginVersions.WPGraphQL.reason

  const shouldDisplayWPGatsbyReason =
    !wpGatsbyIsSatisfied && supportedWpPluginVersions.WPGatsby.reason

  const shouldDisplayAtleastOneReason =
    shouldDisplayWPGraphQLReason || shouldDisplayWPGatsbyReason

  const shouldDisplayBothReasons =
    shouldDisplayWPGraphQLReason && shouldDisplayWPGatsbyReason

  // a message explaining why these are the minimum versions
  const reasons = `${shouldDisplayAtleastOneReason ? `\n\nReasons:\n\n` : ``}${
    shouldDisplayWPGraphQLReason

View on GitHub (pinned to e85d62f177)

Solutions

1. Verify the WordPress URL is reachable and WPGraphQL is active
2. Check the error text for auth/proxy issues
3. Retry the build if the failure was transient

When it happens

Trigger: Thrown at packages/gatsby-source-wordpress/src/steps/check-plugin-requirements.ts:107 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/cd241566a26d3357. Report an issue: GitHub.