Skip to content
Add canonical links to HTML pages Gatsby generates using React Helmet.
Branch: master
Clone or download
Latest commit 8085687 Feb 18, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.


This can be use as a drop in replacement of gatsby-plugin-canonical-urls.

Add canonical links to HTML pages Gatsby generates using react helmet.

This implementation is primarily helpful for distinguishing between https/http, www/no-www but could possibly be extended to help with when sites add multiple paths to the same page.


gatsby-plugin-canonical-urls and gatsby-plugin-react-helmet are plugins that do not always play well together. The first one always inserts a default canonical url, but doesn't allow to override that value in an easy way. When trying to use react helmet to override gatby-plugin-canonical-urls default url, you will end up with two canonical tags.

This plugin, as writes the default canonical url using react helmet, allows to override default canonical url just using the standard react helmet api.


npm install --save gatsby-plugin-react-helmet gatsby-plugin-react-helmet-canonical-urls

How to use

// In your gatsby-config.js
plugins: [
    resolve: `gatsby-plugin-canonical-urls`,
    options: {
      siteUrl: ``,

With the above configuration, the plugin will add to the head of every HTML page a rel=canonical e.g.

<link rel="canonical" href="" />
You can’t perform that action at this time.