Gatsby Book Launch

“The missing guide to the modern web” launches on Thursday, Sep 29th: Modular: The Web’s New Architecture

ContactSign Up for Free
Community Plugin
View plugin on GitHub


This plugin inserts Tealium’s utag to the <body> of Gatsby pages.


npm install --save gatsby-plugin-tealium-utag

How to use

// In your gatsby-config.js
module.exports = {
  plugins: [
      resolve: "gatsby-plugin-tealium-utag",
      options: {
        account: "YOUR_TEALIUM_ACCOUNT",
        profile: "YOUR_TEALIUM_PROFILE",
        env: "dev",
        injectUtagSync: true,
        disableInitialTracking: true

Required Options


Your Tealium account name.


Your Tealium profile name.


Must be "dev", "qa", or "prod".

Optional Options


Defaults to false.

When set to true, utag.sync.js will be injected to the <head>.


Defaults to false.

When set to true, utag.view() won’t be called automatically on page load. Usually, that’s what you want in Single Page Applications.


  • This plugin just adds the utag script to the page. It’s up to you to call utag.view() and in your app.
  • utag.js loads asynchronously. To know when it finished loading, listen to the "utag-loaded" event on the document:
document.addEventListener("utag-loaded", () => {
  console.log("utag is ready:", utag);
© 2022 Gatsby, Inc.