Your version of WPGatsby is too old to determine if we're co

Error message

Your version of WPGatsby is too old to determine if we're compatible.${genericDownloadMessage}

What it means

Error "Your version of WPGatsby is too old to determine if we're compatible.${genericDownloadMessage}" thrown in gatsbyjs/gatsby.

Source

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

      `,
      variables: {
        wpgqlVersion: supportedWpPluginVersions.WPGraphQL.version,
        wpgatsbyVersion: supportedWpPluginVersions.WPGatsby.version,
      },
      panicOnError: false,
      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

View on GitHub (pinned to 8b06340921)

Solutions

Update the WPGatsby plugin on your WordPress site to a current version.
If the plugin cannot be updated, download WPGatsby manually and install it in wp-content/plugins.

When it happens

Trigger: Thrown at packages/gatsby-source-wordpress/src/steps/check-plugin-requirements.ts:101 when the library encounters an invalid state.

Common situations: Occurs when the installed WPGatsby plugin on the WordPress site is too old to report compatibility. Upgrade WPGatsby on the WordPress site to a current version.

AI-assisted analysis of gatsbyjs/gatsby@8b06340921 (2026-08-13). Data as JSON: /api/errors/f13df91b65c8b381. Report an issue: GitHub.