{"record":{"id":"1c3e4037f564f576","repo":"gatsbyjs/gatsby","slug":"plugin-name-is-not-compatible-with-your-gatsby","errorCode":null,"errorMessage":"Plugin ${name} is not compatible with your gatsby version ${gatsbyVersion} - It requires gatsby@${gatsbyPeerDependency}","messagePattern":"Plugin (.+?) is not compatible with your gatsby version (.+?) - It requires gatsby@(.+?)","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby/src/bootstrap/load-plugins/validate.ts","lineNumber":572,"sourceCode":"  }\n\n  return flattenedPlugins\n}\n\nexport function warnOnIncompatiblePeerDependency(\n  name: string,\n  packageJSON: PackageJson\n): void {\n  // Note: In the future the peer dependency should be enforced for all plugins.\n  const gatsbyPeerDependency = _.get(packageJSON, `peerDependencies.gatsby`)\n  if (\n    !isWorker &&\n    gatsbyPeerDependency &&\n    !semver.satisfies(gatsbyVersion, gatsbyPeerDependency, {\n      includePrerelease: true,\n    })\n  ) {\n    reporter.warn(\n      `Plugin ${name} is not compatible with your gatsby version ${gatsbyVersion} - It requires gatsby@${gatsbyPeerDependency}`\n    )\n  }\n}\n","sourceCodeStart":554,"sourceCodeEnd":577,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/e85d62f1779e353eaac1753211629a26d123e26c/packages/gatsby/src/bootstrap/load-plugins/validate.ts#L554-L577","documentation":"Peer-dependency check during plugin resolution: the plugin's package.json declares peerDependencies.gatsby that the currently installed gatsby version does not satisfy (semver, prereleases included). The plugin may use APIs missing in your version; the warning names both versions so you can align them.","triggerScenarios":"Thrown at packages/gatsby/src/bootstrap/load-plugins/validate.ts:572 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Upgrade or downgrade the plugin to a release compatible with your gatsby version (check its peerDependencies)","Or upgrade gatsby to the range the plugin requires","Run a clean install (remove node_modules and lockfile entry) so npm/yarn/pnpm enforces the peer range"],"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"}