Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub

gatsby-plugin-gtag

Add Google Analytics gtag.js to a site

Does the same thing as gatsby-plugin-google-analytics, but instead of adding deprecated analytics.js script, it uses gtag.js. Includes Outbound Link module.

Install

npm install --save gatsby-plugin-gtag

Use


// In your gatsby-config.js
module.exports = {
  plugins: [
    {
      resolve: `gatsby-plugin-gtag`,
      options: {
        // your google analytics tracking id
        trackingId: `UA-XXXXXXXX-X`,
        // Puts tracking script in the head instead of the body
        head: false,
        // enable ip anonymization
        anonymize: true,
      },
    },
  ],
}

import { OutboundLink } from 'gatsby-plugin-gtag'

Use like any other anchor tag in your component: <OutboundLink href='yourwebsite.example'>Check out this site!</OutboundLink>

Options

Puts tracking script in the head instead of the body. Default is false (render in the body)

anonymize

Adds anonymize_ip flag when calling gtag. More info here.

Testing in development mode

By default gatsby-plugin-gtag will only load and run google analytics when process.env.NODE_ENV === 'production'. To enable gtag in development mode set the environment variable GATSBY_GTAG_DEBUG=true gatsby develop.

License

MIT

© 2023 Gatsby, Inc.