Tealium Tools Browser Extension

The Tealium Tools extension provides a standard set of tools used to assist in managing your Tealium deployment and a powerful framework for creating and sharing custom tools from the developer community.

The Tealium Tools extension is built for the following browsers:

  • Google Chrome


Tealium Tools is installed using the Google Chrome browser’s extension marketplace.

To install the Tealium Tools extension on Google Chrome:

  1. In a new Chrome window, go to Tealium Tools Chrome Extension.
  2. Click + Add to Chrome.
  3. Click Add extension to confirm.
    Confirm that the button now displays Added to Chrome and that the Tealium icon displays on the upper right of the Chrome toolbar.
  4. Click the Tealium icon in the upper right of the Chrome window to open Tealium Tools and select a tool to use.

The Tealium Tools window is organized into the following two tabs:

  • Home
    Contains official Tealium built-in tools.
    Tealium Tools Browser Extension.png
  • Custom Tools
    Allows you to manage and run custom tools.

Manage custom tools

The Tealium Tools extension provides a flexible and powerful framework for using, building, and sharing custom tools. Once a custom tool is created, it can be shared and installed by other users. This section provides basic information about adding and removing custom tools.

For information about available custom tools, see List of Custom Tealium Tools.

Add a custom tool

You can add custom tool from the Example Tools tab or by cutting and pasting the URL or JSON definition for the tool. Use the following steps to add a custom tool:

  1. Open Tealium Tools from your browser.

  2. Click the Custom Tools tab.

  3. Click the + Custom Tools tile.
    Tealium Tools Click Custom Tools Tab.png

  4. To add a tool from the examples, click the Example Tools tab, select a tool, click View Details > Add this Custom Tool.
    Tealum Tools Add Custom Tool From Example.png

  5. To add a tool using a URL or JSON definition, click the Add Custom Tools tab and add the tool using one of the following methods:

    • To add by URL, go to the Add by URL field, copy and paste the URL and click Add Custom Tool.
    • To add by JSON definition, go to the Add by JSON definition field, copy and paste the URL JSON definition object and click Add Custom Tool.
      Tealium Tools Add Custom by Cut and Paste.png
      When successful, a “Success!” message displays.
  6. Click Close.
    Tealium Tools Addition Success Message.png

  7. Click Exit.
    The new tool now displays on the Custom Tools tab.

    If the tool does not provide its own logo, the initials of the name of the tool displays on the button.

  8. Click the button for the tool to begin to use.

Remove a custom tool

Use the following steps to remove a custom tool:

  1. Open Tealium Tools from your browser.
  2. Click the Custom Tools tab.
  3. Click + Custom Tool.
  4. Click the Remove Custom Tools tab.
    A list of custom tools displays.
  5. From the list, scroll up or down to find the custom tool you want to remove and click Remove.
    To remove all custom tools, scroll to the bottom and click Remove All Custom Tools.
    Tealium Tools Remove Custom Tools.png
    When successful, a “Success!” message displays.
  6. Click Close.
  7. Click Exit.
    The tool removed no longer displays in the Custom Tools view.

Official Tealium Tools

The following is a list of Tealium Tools that are built into the extension:

  • Tealium iQ
    A bookmark link to the iQ Tag Management interface.
  • Web Companion
    A browser tool used to audit your tag configuration, inspect data on your site, and create and test new configurations quickly and easily.
  • TLC
    A bookmark link to the Tealium Learning Community.
  • AudienceStream Trace
    Trace provides the necessary tools to put your Universal Data Hub configuration to the test. With Trace, you can observe every detail of a defined workflow, ensure attributes update correctly, rules are dialed in, and actions fire as expected. Trace works in real-time, so you know immediately what works and what needs adjusting.
  • Optimizely Helper
    Tealium AudienceStream enables marketers to discover audiences, enrich visitor profiles and stitch together customer interactions across digital touch points. Using both AudienceStream and Optimizely, users can leverage the audiences created in AudienceStream and build targeted experiments in Optimizely.
  • Environment Switcher
    The environment switcher is a powerful testing tool that allows you to change the Tealium files (utag.js, utag.sync.js) that are loaded on a page by specifying an environment (Dev, QA, Prod, Custom) and/or an account and profile.


Use the following steps to remove the Tealium Tools extension for the Google Chrome browser:

  1. In a Chrome browser window, click More Tools > Extensions.
    Chrome More Tools Extensions Newer.png
  2. Navigate to the Tealium Tools extension and click Remove.
    You can optionally leave the Tealium Tools installed and toggle it off to temporarily disable.
    Tealium Tools_Chrome Extension_Remove.jpg
    A confirmation dialog displays.
  3. Click Remove again to confirm.

Additional information

Was this page helpful?

This page was last updated: January 7, 2023