{"record":{"id":"9552b388f580e79a","repo":"gatsbyjs/gatsby","slug":"disabling-plugin-plugin-name-n-disabledinfo","errorCode":null,"errorMessage":"Disabling plugin \"${plugin.name}\":\\n${disabledInfo.reasons}","messagePattern":"Disabling plugin \"(.+?)\":\\\\n(.+?)","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby/src/bootstrap/load-plugins/index.ts","lineNumber":51,"sourceCode":"    ssr: ssrAPIs,\n  })\n\n  // Collate internal plugins, site config plugins, site default plugins\n  const pluginInfos = loadInternalPlugins(config, rootDir)\n\n  // Create a flattened array of the plugins\n  const pluginArray = flattenPlugins(pluginInfos)\n\n  const { disablePlugins } = store.getState().program\n  const pluginArrayWithoutDisabledPlugins = pluginArray.filter(plugin => {\n    const disabledInfo = disablePlugins?.find(\n      entry => entry.name === plugin.name\n    )\n\n    if (disabledInfo) {\n      if (!process.env.GATSBY_WORKER_ID) {\n        // show this warning only once in main process\n        reporter.warn(\n          `Disabling plugin \"${plugin.name}\":\\n${disabledInfo.reasons\n            .map(line => ` - ${line}`)\n            .join(`\\n`)}`\n        )\n      }\n      return false\n    }\n    return true\n  })\n\n  // Work out which plugins use which APIs, including those which are not\n  // valid Gatsby APIs, aka 'badExports'\n  let { flattenedPlugins, badExports } = await collatePluginAPIs({\n    currentAPIs,\n    flattenedPlugins: pluginArrayWithoutDisabledPlugins,\n    rootDir,\n  })\n","sourceCodeStart":33,"sourceCodeEnd":69,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/e85d62f1779e353eaac1753211629a26d123e26c/packages/gatsby/src/bootstrap/load-plugins/index.ts#L33-L69","documentation":"Startup filter warning during plugin loading: the site's config (CLI flags like `--unstable-skip-plugin` / program.disablePlugins) marks this plugin as disabled, and the flattened plugin array drops it before APIs are collected. The warning (main process only, once) lists the recorded reasons; the build proceeds without that plugin's APIs.","triggerScenarios":"Thrown at packages/gatsby/src/bootstrap/load-plugins/index.ts:51 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Review the disablePlugins entry / CLI flag that named this plugin and remove it if the plugin is needed","Re-enable the plugin to restore its node/browser/ssr APIs","If disabled intentionally (e.g. skipping gatsby-plugin-manifest), verify the site works without its effects"],"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"}