Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub

NPM package downloads Depfu Code size Repo size



Provides drop-in support for server rendering data added with React Helmet Async.

React Helmet Async is a component which lets you control your document head using their React component.

With this plugin, attributes you add in their component, e.g. title, meta attributes, etc. will get added to the static HTML pages Gatsby builds.

This is important not just for site viewers, but also for SEO — title and description metadata stored in the document head is a key component used by Google in determining placement in search results.

How to install

Replace yarn add with npm i if you’re using npm, or pnpm add for pnpm:

yarn add react-helmet-async gatsby-plugin-react-helmet-async

react-helmet-async requires your react and react-dom to be at least 16.6.0. If they’re older than that, you’ll need to upgrade them:

yarn add react@^16.6.0 react-dom@^16.6.0

Using TypeScript

This package includes its own types, as do gatsby and react-helmet-async. To get types for the other packages, you’ll need to install them separately:

yarn add -D @types/react @types/react-dom

How to use

Just add the plugin to the plugins array in your gatsby-config.js:

module.exports = {
    plugins: [`gatsby-plugin-react-helmet-async`]
© 2023 Gatsby, Inc.