{"record":{"id":"9c45178bba0af444","repo":"gatsbyjs/gatsby","slug":"wpgraphql-returned-a-debug-message-on-startup","errorCode":null,"errorMessage":"WPGraphQL returned a debug message on startup:\n\n${firstError.debugMessage || firstError.message}\n          ","messagePattern":"WPGraphQL returned a debug message on startup:\n\n(.+?)\n          ","errorType":"panic","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby-source-wordpress/src/steps/check-plugin-requirements.ts","lineNumber":217,"sourceCode":"  helpers,\n}: {\n  url: string\n  helpers: NodePluginArgs\n}): Promise<void> =>\n  fetch(url)\n    .then(response => response.json())\n    .then(json => {\n      if (json?.errors?.length) {\n        const firstError = json.errors[0]\n\n        if (\n          firstError.debugMessage ||\n          (firstError.message &&\n            !firstError.message?.includes(\n              `GraphQL Request must include at least one of those two parameters: \"query\" or \"queryId\"`\n            ))\n        ) {\n          helpers.reporter.panic(\n            formatLogMessage(`WPGraphQL returned a debug message on startup:\n\n${firstError.debugMessage || firstError.message}\n          `)\n          )\n        }\n      }\n    })\n    .catch(() => {\n      // this is ignored because a /graphql request will always return a 200 at this point\n      // we've already checked prior to this point that /graphql is up and returns a response.\n    })\n\nconst isWpGatsby = async (): Promise<void> => {\n  fetchGraphql({\n    query: /* GraphQL */ `\n      {\n        isWpGatsby","sourceCodeStart":199,"sourceCodeEnd":235,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/8b06340921ffdf23125a365b9c9923690cb62ce6/packages/gatsby-source-wordpress/src/steps/check-plugin-requirements.ts#L199-L235","documentation":"Error \"WPGraphQL returned a debug message on startup:\n\n${firstError.debugMessage || firstError.message}\n          \" thrown in gatsbyjs/gatsby.","triggerScenarios":"Thrown at packages/gatsby-source-wordpress/src/steps/check-plugin-requirements.ts:217 when the library encounters an invalid state.","commonSituations":"Occurs when WPGraphQL emits a debug message at startup, usually because WPGraphQL debug mode is enabled or another plugin conflicts. Disable WPGraphQL debug mode in production and resolve the reported message.","solutions":["Fix the WPGraphQL startup problem reported in the debug message on the WordPress side (often a conflicting plugin or PHP error).","Enable WP_DEBUG on the WordPress site to get more detail, resolve the issue, then rebuild."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"8b06340921ffdf23125a365b9c9923690cb62ce6","analyzedAt":"2026-08-13T02:36:21.405Z","schemaVersion":2},"datasetVersion":"2026-08-13T04:17:16.726Z"}