{"record":{"id":"b86c690dedc6b2bf","repo":"gatsbyjs/gatsby","slug":"the-type-mediaitem-lazynodes-option-isn-t-supporte","errorCode":null,"errorMessage":"The type.MediaItem.lazyNodes option isn't supported in Gatsby v4+ due to query running using JS workers in PQR (Parallell Query Running). lazyNodes creates nodes in GraphQL resolvers and PQR doesn't support that.\n\nIf you would like to prevent gatsby-source-wordpress from fetching File nodes for each MediaItem node, set the type.MediaItem.createFileNodes option to false.","messagePattern":"The type\\.MediaItem\\.lazyNodes option isn't supported in Gatsby v4\\+ due to query running using JS workers in PQR \\(Parallell Query Running\\)\\. lazyNodes creates nodes in GraphQL resolvers and PQR doesn't support that\\.\n\nIf you would like to prevent gatsby-source-wordpress from fetching File nodes for each MediaItem node, set the type\\.MediaItem\\.createFileNodes option to false\\.","errorType":"panic","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby-source-wordpress/src/steps/process-and-validate-plugin-options.ts","lineNumber":29,"sourceCode":"  helpers: GatsbyNodeApiHelpers\n}\n\ninterface IOptionsProcessor {\n  name: string\n  test: (options: IProcessorOptions) => boolean\n  processor: (options: IProcessorOptions) => IPluginOptions | void\n}\n\nlet warnedAboutMediaItemLazyNodes = false\n\nconst optionsProcessors: Array<IOptionsProcessor> = [\n  {\n    name: `MediaItem.lazyNodes doesn't work in Gatsby v4+`,\n    test: ({ userPluginOptions }): boolean =>\n      userPluginOptions?.type?.MediaItem?.lazyNodes,\n    processor: ({ helpers, userPluginOptions }): IPluginOptions => {\n      if (usingGatsbyV4OrGreater) {\n        helpers.reporter.panic(\n          formatLogMessage(\n            `The type.MediaItem.lazyNodes option isn't supported in Gatsby v4+ due to query running using JS workers in PQR (Parallell Query Running). lazyNodes creates nodes in GraphQL resolvers and PQR doesn't support that.\\n\\nIf you would like to prevent gatsby-source-wordpress from fetching File nodes for each MediaItem node, set the type.MediaItem.createFileNodes option to false.`\n          )\n        )\n      } else if (!warnedAboutMediaItemLazyNodes) {\n        warnedAboutMediaItemLazyNodes = true\n        helpers.reporter.warn(\n          formatLogMessage(\n            `\\nThe type.MediaItem.lazyNodes option wont be supported in Gatsby v4+ due to query running using JS workers in PQR (Parallell Query Running). lazyNodes creates nodes in GraphQL resolvers and PQR doesn't support that.\\n\\nThis option works with your current version of Gatsby but will stop working in Gatsby v4+.\\n\\nIf you would like to prevent gatsby-source-wordpress from fetching File nodes for each MediaItem node, set the type.MediaItem.createFileNodes option to false instead.\\n`\n          )\n        )\n      }\n\n      return userPluginOptions\n    },\n  },\n  {\n    name: `pluginOptions.type.MediaItem.limit is not allowed`,","sourceCodeStart":11,"sourceCodeEnd":47,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/8b06340921ffdf23125a365b9c9923690cb62ce6/packages/gatsby-source-wordpress/src/steps/process-and-validate-plugin-options.ts#L11-L47","documentation":"Error \"The type.MediaItem.lazyNodes option isn't supported in Gatsby v4+ due to query running using JS workers in PQR (Parallell Query Running). lazyNodes creates nodes in GraphQL resolvers and PQR doesn't support that.\n\nIf you would like to prevent gatsby-source-wordpress from fetching File nodes for each MediaItem node, set the type.MediaItem.createFileNodes option to false.\" thrown in gatsbyjs/gatsby.","triggerScenarios":"Thrown at packages/gatsby-source-wordpress/src/steps/process-and-validate-plugin-options.ts:29 when the library encounters an invalid state.","commonSituations":"Occurs when type.MediaItem.lazyNodes is enabled in Gatsby v4+, which is incompatible with Parallel Query Running. Remove lazyNodes and set type.MediaItem.createFileNodes to false if File nodes are unwanted.","solutions":["Remove the type.MediaItem.lazyNodes option from gatsby-config.js.","To avoid fetching File nodes for MediaItems, set type.MediaItem.createFileNodes to false instead."],"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"}