{"record":{"id":"1104a6719b176b3b","repo":"gatsbyjs/gatsby","slug":"sourcepreview-was-called-but-the-required-previewd","errorCode":null,"errorMessage":"sourcePreview was called but the required previewData properties weren't provided.","messagePattern":"sourcePreview was called but the required previewData properties weren't provided\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby-source-wordpress/src/steps/preview/index.ts","lineNumber":252,"sourceCode":"    return\n  }\n\n  const requiredProperties = [\n    `previewDatabaseId`,\n    `id`,\n    `token`,\n    `remoteUrl`,\n    `parentDatabaseId`,\n    `modified`,\n    `userDatabaseId`,\n  ]\n\n  const missingProperties = requiredProperties.filter(\n    property => !(property in previewData)\n  )\n\n  if (!previewData || missingProperties.length) {\n    reporter.warn(\n      formatLogMessage(\n        `sourcePreview was called but the required previewData properties weren't provided.`\n      )\n    )\n    reporter.info(\n      formatLogMessage(\n        `Missing properties: \\n${JSON.stringify(missingProperties, null, 2)}`\n      )\n    )\n    reporter.log(\n      formatLogMessage(`previewData: \\n${JSON.stringify(previewData, null, 2)}`)\n    )\n    return\n  }\n\n  await touchValidNodes()\n\n  const sendPreviewStatus = createPreviewStatusCallback({","sourceCodeStart":234,"sourceCodeEnd":270,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/e85d62f1779e353eaac1753211629a26d123e26c/packages/gatsby-source-wordpress/src/steps/preview/index.ts#L234-L270","documentation":"In sourcePreview, the incoming preview webhook payload is checked against the required previewData properties (previewDatabaseId, id, token, remoteUrl, parentDatabaseId, modified, userDatabaseId). The warning fires when the payload is missing one or more of them (or is falsy), meaning the preview request is unusable; the missing keys are logged via reporter.info and the preview run is aborted.","triggerScenarios":"Thrown at packages/gatsby-source-wordpress/src/steps/preview/index.ts:252 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Inspect the logged 'Missing properties' list and fix the preview sender to include all required fields.","Ensure the WPGatsby plugin in WordPress is up to date so it sends the full payload.","Verify nothing (proxy/middleware) is stripping fields from the webhook body.","Check that the preview request originates from the correct WordPress instance."],"exampleFix":null,"handlingStrategy":"type-guard","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"e85d62f1779e353eaac1753211629a26d123e26c","analyzedAt":"2026-08-26T17:50:09.662Z","contentChangedAt":"2026-08-26T17:50:09.662Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}