gatsbyjs/gatsby · error

${message}

Error message

${message}

What it means

areRemotePluginVersionsSatisfied assembles a detailed message when WPGatsby/WPGraphQL version checks fail and panics with it. The message embeds the supported ranges, the site's actual versions, and numbered remedies (upgrade gatsby-source-wordpress or WPGatsby, with download links).

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 e85d62f177)

Solutions

1. Upgrade WPGatsby/WPGraphQL to a version within the supported range
2. Upgrade gatsby-source-wordpress if site plugin versions are newer
3. Follow the wp-admin plugins.php link in the message to update

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: See trigger scenarios.

AI-assisted analysis of gatsbyjs/gatsby@e85d62f177 (2026-08-26). Data as JSON: /api/errors/0649f850681cc75c. Report an issue: GitHub.