gatsbyjs/gatsby · error

gatsby-plugin-react-helmet: Gatsby now has built-in support

Error message

gatsby-plugin-react-helmet: Gatsby now has built-in support for modifying the document head. Learn more at https://gatsby.dev/gatsby-head

What it means

Deprecation notice emitted unconditionally by gatsby-plugin-react-helmet's onPreInit: since Gatsby 4.x the framework natively supports setting document head tags (SEO meta, title, etc.) by rendering <title>/<meta> elements in components, so this plugin (and the react-helmet dependency) is no longer needed.

Source

Thrown at packages/gatsby-plugin-react-helmet/src/gatsby-node.js:4

exports.pluginOptionsSchema = ({ Joi }) => Joi.object({})

exports.onPreInit = ({ reporter }) => {
  reporter.warn(
    `gatsby-plugin-react-helmet: Gatsby now has built-in support for modifying the document head. Learn more at https://gatsby.dev/gatsby-head`
  )
}

View on GitHub (pinned to e85d62f177)

Solutions

  1. Remove gatsby-plugin-react-helmet and react-helmet
  2. Migrate to the built-in Head API (https://gatsby.dev/gatsby-head)
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at packages/gatsby-plugin-react-helmet/src/gatsby-node.js:4 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/f21936a978b04c2c. Report an issue: GitHub.