gatsbyjs/gatsby · error

The ${name} plugin has generated no Gatsby nodes. Do you nee

Error message

The ${name} plugin has generated no Gatsby nodes. Do you need it? This could also suggest the plugin is misconfigured.

What it means

Guard in warnForPluginsWithoutNodes, run after sourceNodes: any plugin that implements sourceNodes but created zero nodes during the run is flagged. The input at fault is the plugin itself — either it is unnecessary for the site, or its sourceNodes logic (fetching, filtering, conditional returns) silently produced no nodes.

Source

Thrown at packages/gatsby/src/utils/source-nodes.ts:44

  return flattenedPlugins
    .filter(
      plugin =>
        // "Can generate nodes"
        plugin.nodeAPIs.includes(`sourceNodes`) &&
        // "Has not generated nodes"
        !pluginNamesThatCreatedNodes.has(plugin.name)
    )
    .map(plugin => plugin.name)
}

/**
 * Warn about plugins that should have created nodes but didn't.
 */
function warnForPluginsWithoutNodes(): void {
  const pluginNamesWithNoNodes = discoverPluginNamesWithoutNodes()

  pluginNamesWithNoNodes.map(name =>
    report.warn(
      `The ${name} plugin has generated no Gatsby nodes. Do you need it? This could also suggest the plugin is misconfigured.`
    )
  )
}

/**
 * Return the set of nodes for which its root node has not been touched
 */
function getStaleNodes(
  state: IGatsbyState,
  nodes: GatsbyIterable<IGatsbyNode>
): GatsbyIterable<IGatsbyNode> {
  return nodes.filter(node => {
    let rootNode = node
    let next: IGatsbyNode | undefined = undefined

    let whileCount = 0
    do {

View on GitHub (pinned to e85d62f177)

Solutions

1. Remove the plugin from gatsby-config.js if it is not needed
2. Check the plugin's configuration/credentials so its sourceNodes call actually fetches data
3. Debug the plugin's createNode calls to find why no nodes are created

When it happens

Trigger: Thrown at packages/gatsby/src/utils/source-nodes.ts:44 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/99be7da2f3f32425. Report an issue: GitHub.