{"record":{"id":"9b80bd802b259ccf","repo":"gatsbyjs/gatsby","slug":"warning-there-are-unknown-plugin-options-for-p","errorCode":null,"errorMessage":"Warning: there are unknown plugin options for \"${plugin.resolve}\", configured by ${configDir}: ${validationWarnings}\\nPlease open an issue at https://ghub.io/${plugin.resolve} if you believe this option is valid.","messagePattern":"Warning: there are unknown plugin options for \"(.+?)\", configured by (.+?): (.+?)\\\\nPlease open an issue at https://ghub\\.io/(.+?) if you believe this option is valid\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby/src/bootstrap/load-plugins/validate.ts","lineNumber":352,"sourceCode":"          // do not have subplugins. We add plugins to the schema if it does not exist already\n          // to make sure they pass validation.\n          optionsSchema = optionsSchema.append({\n            plugins: Joi.array().length(0),\n          })\n        }\n\n        const { value, warning } = await validateOptionsSchema(\n          optionsSchema,\n          (plugin.options as IPluginInfoOptions) || {}\n        )\n\n        plugin.options = value\n\n        // Handle unknown key warnings\n        const validationWarnings = warning?.details\n\n        if (validationWarnings?.length > 0) {\n          reporter.warn(\n            stripIndent(`\n        Warning: there are unknown plugin options for \"${plugin.resolve}\"${\n              configDir ? `, configured by ${configDir}` : ``\n            }: ${validationWarnings\n              .map(error => error.path.join(`.`))\n              .join(`, `)}\n        Please open an issue at https://ghub.io/${\n          plugin.resolve\n        } if you believe this option is valid.\n      `)\n          )\n          // We do not increment errors++ here as we do not want to process.exit if there are only warnings\n        }\n\n        // Validate subplugins if they weren't handled already\n        if (!subPluginPaths.has(`plugins`) && plugin.options?.plugins) {\n          const { errors: subErrors, plugins: subPlugins } =\n            await validatePluginsOptions(","sourceCodeStart":334,"sourceCodeEnd":370,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/e85d62f1779e353eaac1753211629a26d123e26c/packages/gatsby/src/bootstrap/load-plugins/validate.ts#L334-L370","documentation":"Error \"Warning: there are unknown plugin options for \"${plugin.resolve}\", configured by ${configDir}: ${validationWarnings}\\nPlease open an issue at https://ghub.io/${plugin.resolve} if you believe this option is valid.\" thrown in gatsbyjs/gatsby.","triggerScenarios":"Thrown at packages/gatsby/src/bootstrap/load-plugins/validate.ts:352 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check gatsby-config.js for the named plugin and fix/remove the unrecognized option keys listed in the warning","Consult the plugin's README for the correct option names (often a rename or typo)","If the option is genuinely supported, update the plugin so its pluginOptionsSchema includes it, or open an issue at the linked repo"],"exampleFix":null,"handlingStrategy":"validation","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"}