gatsbyjs/gatsby · error

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

Error message

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

What it means

areRemotePluginVersionsSatisfied queries wpGatsbyCompatibility on the WP site; if the GraphQL error indicates that field does not exist, the installed WPGatsby plugin predates that API. The panic tells the user their WPGatsby version is too old to even evaluate compatibility and to update it.

Solutions

1. Update the WPGatsby plugin on your WordPress site to a current version.
2. 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.

Appendix: 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)