Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub


WARNING: The whitelist option introduced in react-head@next is not working properly at least not using the below mentioned whitelist.

Please check my PR#84 over at react-head if you’re interested in the details.

This plugin sets up react-head with server-rendering for you.

More about thread-safe meta tag management with react-head


npm install --save react-head@next @canrau/gatsby-plugin-react-head


@canrau/gatsby-plugin-react-head depends on react-head!
To use the new whitelist feature you have to specifically install react-head@next as shown above, the whitelist option hasn’t been merged into the main release so far as it’s still a proof of concept.

The un-namespaced version gatsby-plugin-react-head doesn’t support the whitelist option.


Add the plugin to your gatsby-config.js.

module.exports = {
  plugins: [
      resolve: `@canrau/gatsby-plugin-react-head`,
      // optional options
      options: {
        // an array of whitelisted tags to disable `[data-rh]` attribute for them
        whitelist: [


import * as React from 'react';
import { Title, Link, Meta } from 'react-head';

const App = () => (
    <Link rel="canonical" content="http://www.gaiama.org/" />
    <Meta name="description" content="Protecting Amazonian rainforest in Peru" />
    // ...


MIT © Can Rau

© 2023 Gatsby, Inc.