gatsbyjs/gatsby · error

Disabling plugin "${plugin.name}":\n${disabledInfo.reasons}

Error message

Disabling plugin "${plugin.name}":\n${disabledInfo.reasons}

What it means

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.

Source

Thrown at packages/gatsby/src/bootstrap/load-plugins/index.ts:51

    ssr: ssrAPIs,
  })

  // Collate internal plugins, site config plugins, site default plugins
  const pluginInfos = loadInternalPlugins(config, rootDir)

  // Create a flattened array of the plugins
  const pluginArray = flattenPlugins(pluginInfos)

  const { disablePlugins } = store.getState().program
  const pluginArrayWithoutDisabledPlugins = pluginArray.filter(plugin => {
    const disabledInfo = disablePlugins?.find(
      entry => entry.name === plugin.name
    )

    if (disabledInfo) {
      if (!process.env.GATSBY_WORKER_ID) {
        // show this warning only once in main process
        reporter.warn(
          `Disabling plugin "${plugin.name}":\n${disabledInfo.reasons
            .map(line => ` - ${line}`)
            .join(`\n`)}`
        )
      }
      return false
    }
    return true
  })

  // Work out which plugins use which APIs, including those which are not
  // valid Gatsby APIs, aka 'badExports'
  let { flattenedPlugins, badExports } = await collatePluginAPIs({
    currentAPIs,
    flattenedPlugins: pluginArrayWithoutDisabledPlugins,
    rootDir,
  })

View on GitHub (pinned to e85d62f177)

Solutions

1. Review the disablePlugins entry / CLI flag that named this plugin and remove it if the plugin is needed
2. Re-enable the plugin to restore its node/browser/ssr APIs
3. If disabled intentionally (e.g. skipping gatsby-plugin-manifest), verify the site works without its effects

When it happens

Trigger: Thrown at packages/gatsby/src/bootstrap/load-plugins/index.ts:51 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of gatsbyjs/gatsby@e85d62f177 (2026-08-26). Data as JSON: /api/errors/9552b388f580e79a. Report an issue: GitHub.