Real World Performance: lazy loading, optimizing media, faster analytics join us Wednesday

ContactSign Up
Community Plugin
View plugin on GitHub


Easily add Umami to your Gatsby site.


npm install --save gatsby-plugin-umami

How to use

// In your gatsby-config.js
plugins: [
    resolve: `gatsby-plugin-umami`,
    options: {
      websiteId: 'UMAMI_WEBSITE_ID',
      srcUrl: '',
      includeInDevelopment: false,
      autoTrack: true,
      respectDoNotTrack: true,
      dataCache: false,
      dataDomains: ','


  • websiteId - Required. The website id of your umami site
  • srcUrl - Required. The url to the hosted umami.js
  • includeInDevelopment - Optional. Defaults to false
  • autoTrack - Optional. Enables umami auto track feature. Defaults to true
  • respectDoNotTrack - Optional. Enables umami respect Do Not Track feature. Defaults to true
  • dataCache - Optional. Improves performance. Defaults to false
  • dataDomains - Optional. Allows tracking only on the specified domains. No default.
© 2023 Gatsby, Inc.