Your remote version of WPGraphQL is not within the accepted

Error message

Your remote version of WPGraphQL is not within the accepted range
(${supportedWpPluginVersions.WPGraphQL.version}).

This is not a bug and it means one of two things:
 you either need to upgrade WPGraphQL or gatsby-source-wordpress.

What it means

Error "Your remote version of WPGraphQL is not within the accepted range (${supportedWpPluginVersions.WPGraphQL.version}). This is not a bug and it means one of two things: you either need to upgrade WPGraphQL or gatsby-source-wordpress." thrown in gatsbyjs/gatsby.

Source

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

1. If the version of WPGatsby in your WordPress instance is higher than ${
      maxVersion || minVersion
    }
it means you need to upgrade your version of gatsby-source-wordpress.

2. If the version of WPGatsby in your WordPress instance is lower than ${minVersion}
it means you need to upgrade your version of WPGatsby.

Download a matching version at https://github.com/gatsbyjs/wp-gatsby/releases
or update via ${protocol}//${hostname}/wp-admin/plugins.php`
  }

  if (!wpGatsbyIsSatisfied || !wpgqlIsSatisfied) {
    message += `
${reasons}`
  }

  if (message) {
    helpers.reporter.panic(formatLogMessage(message))
  }
}

// This blank request is used to find debug messages
// when a graphql request is made with no query
// for example if 2 root fields are registered with the fieldname "products"
// this will throw a helpful error message explaining that one should be removed
const blankGetRequest = async ({
  url,
  helpers,
}: {
  url: string
  helpers: NodePluginArgs
}): Promise<void> =>
  fetch(url)
    .then(response => response.json())
    .then(json => {
      if (json?.errors?.length) {

View on GitHub (pinned to 8b06340921)

Solutions

Upgrade WPGraphQL on the WordPress site to a version inside the supported range.
Alternatively upgrade gatsby-source-wordpress so its supported range covers your installed WPGraphQL version.

When it happens

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

Common situations: Occurs when the remote WPGraphQL version falls outside the range supported by gatsby-source-wordpress. Upgrade WPGraphQL on the WordPress site, or downgrade/upgrade gatsby-source-wordpress to a compatible version.

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