{"record":{"id":"9e6131804cac0899","repo":"gatsbyjs/gatsby","slug":"if-the-schema-change-includes-a-data-change-you-ll","errorCode":null,"errorMessage":"If the schema change includes a data change\nyou'll need to run `gatsby clean && gatsby develop` to see the data update.","messagePattern":"If the schema change includes a data change\nyou'll need to run `gatsby clean && gatsby develop` to see the data update\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby-source-wordpress/src/steps/ingest-remote-schema/diff-schemas.js","lineNumber":139,"sourceCode":"  }\n\n  await setPersistentCache({\n    key: pluginOptionsMD5Key,\n    value: pluginOptionsMD5,\n  })\n\n  if (\n    lastCompletedSourceTime &&\n    schemaWasChanged &&\n    pluginOptions &&\n    pluginOptions.verbose\n  ) {\n    helpers.reporter.log(``)\n    helpers.reporter.warn(\n      formatLogMessage(`The remote schema has changed, updating local schema.`)\n    )\n    if (process.env.NODE_ENV === `development`) {\n      helpers.reporter.warn(\n        formatLogMessage(\n          `If the schema change includes a data change\\nyou'll need to run \\`gatsby clean && gatsby develop\\` to see the data update.`\n        )\n      )\n    }\n    helpers.reporter.info(\n      formatLogMessage(`Cached schema md5: ${cachedSchemaMd5}`)\n    )\n    helpers.reporter.info(formatLogMessage(`Remote schema md5: ${schemaMd5}`))\n    helpers.reporter.log(``)\n  } else if (!lastCompletedSourceTime && pluginOptions.verbose) {\n    helpers.reporter.log(``)\n    helpers.reporter.info(\n      formatLogMessage(\n        `\\n\\n\\tThis is either your first build or the cache was cleared.\\n\\tPlease wait while your WordPress data is synced to your Gatsby cache.\\n\\n\\tMaybe now's a good time to get up and stretch? :D\\n`\n      )\n    )\n  }","sourceCodeStart":121,"sourceCodeEnd":157,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/e85d62f1779e353eaac1753211629a26d123e26c/packages/gatsby-source-wordpress/src/steps/ingest-remote-schema/diff-schemas.js#L121-L157","documentation":"A follow-up warning in checkIfSchemaHasChanged, shown in development when verbose is on and the remote schema changed. It explains a caching nuance: schema changes that also carry data changes can leave stale cached node data behind, so a clean cache is required to observe the update. Purely informational.","triggerScenarios":"Thrown at packages/gatsby-source-wordpress/src/steps/ingest-remote-schema/diff-schemas.js:139 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Run gatsby clean followed by gatsby develop to discard the hard cache and see updated data.","Or delete .cache/wordpress-{...} hard cache files manually.","If only the schema (not data) changed, no action is needed."],"exampleFix":null,"handlingStrategy":"fallback","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-14T05:17:10.506Z"}