Skip to main content

Adding analytics

Why use analytics?

Once you have your site live you will start wanting to get an idea of how many visitors are coming to your site along with other metrics such as:

  • What pages are most popular?
  • Where do my visitors come from?
  • When do people visit my site?

Google Analytics provides a way to collect this data and perform analytics on it answering the above questions among many others. The platform is free for 10 million hits per month per Tracking ID. There are other analytics options—see the “Other Gatsby analytics plugins” section at the bottom of this doc for ideas.

Setting up Google Analytics

The first step is to set up a Google Analytics account. You can do that here by signing in with your Google Account.

Google also has a get started page for reference.

Once you have an account, you will be prompted to set up a new property. This property will have a Tracking ID associated with it. In this case the property will be the website itself. Fill out the form with your website name and URL.

The Tracking ID is what is used to identify data with your site’s traffic. You would typically use a different Tracking ID for each website you are monitoring.

You should now have a Tracking ID; take note of it, as your website will need to reference it when sending page views to Google Analytics. It should be in the format UA-XXXXXXXXX-X.

You can find this tracking ID later by going to Admin > Tracking Info > Tracking Code.

Using gatsby-plugin-google-analytics

Now, it’s time to configure Gatsby to send page views to your Google Analytics account.

We are going to use gatsby-plugin-google-analytics. For other analytics options (including Google Analytics gtag.js and Google Tag Manager), check other Gatsby analytics plugins.

npm install --save gatsby-plugin-google-analytics
gatsby-config.js
    {
      resolve: `gatsby-plugin-google-analytics`,
      options: {
      // replace "UA-XXXXXXXXX-X" with your own Tracking ID
        trackingId: "UA-XXXXXXXXX-X",
      },
    },

Note: You’ll need to replace UA-XXXXXXXXX-X with your own Tracking ID.

Full documentation for the plugin can be found here.

There are a number of extra configuration options—both with the Gatsby plugin and also in your Google Analytics account—so you can tailor things to meet your website’s needs.

Once this is configured you can deploy your site to test! If you navigate to the homepage of Google Analytics, you should see a dashboard with different statistics.

Other Gatsby analytics plugins


Was this helpful? edit this page on GitHub