gatsbyjs/gatsby · error

[deprecated${plugin ? " " + plugin.name : ""}] node.fs is de

Error message

[deprecated${plugin ? " " + plugin.name : ""}] node.fs is deprecated. Please set "resolve.fallback.fs = false".

What it means

A deprecation notice from the actions layer: using node.fs (the webpack node-filesystem polyfill hook exposed via setWebpackConfig-style actions) is deprecated because Gatsby's webpack config no longer polyfills node core modules; sites must explicitly disable the fs fallback in webpack resolve options. This is a generic deprecation wrapper warning, not a fault in the site's data.

Source

Thrown at packages/gatsby/src/redux/actions/public.js:1000

  return {
    type: `ADD_CHILD_NODE_TO_PARENT_NODE`,
    plugin,
    payload: parent,
  }
}

/**
 * Merge additional configuration into the current webpack config. A few
 * configurations options will be ignored if set, in order to try prevent accidental breakage.
 * Specifically, any change to `entry`, `output`, `target`, or `resolveLoaders` will be ignored.
 *
 * For full control over the webpack config, use `replaceWebpackConfig()`.
 *
 * @param {Object} config partial webpack config, to be merged into the current one
 */
actions.setWebpackConfig = (config: Object, plugin?: ?Plugin = null) => {
  if (config.node?.fs === `empty`) {
    report.warn(
      `[deprecated${
        plugin ? ` ` + plugin.name : ``
      }] node.fs is deprecated. Please set "resolve.fallback.fs = false".`
    )
    delete config.node.fs
    config.resolve = config.resolve || {}
    config.resolve.fallback = config.resolve.fallback || {}
    config.resolve.fallback.fs = false
  }

  return {
    type: `SET_WEBPACK_CONFIG`,
    plugin,
    payload: config,
  }
}

/**

View on GitHub (pinned to e85d62f177)

Solutions

1. Replace node.fs usage with webpack config `resolve: { fallback: { fs: false } }` via setWebpackConfig in gatsby-node
2. Remove the node.fs action call and any plugin relying on it
3. Update to plugins versions that no longer use node.fs

When it happens

Trigger: Thrown at packages/gatsby/src/redux/actions/public.js:1000 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/a46ee572c0d0edd5. Report an issue: GitHub.