This article provides an overview of the Tealium Tools browser extension, available for Google Chrome.

In this article:

Table of Contents Placeholder

How It Works

The Tealium Tools extension provides a standard set of tools used to assist in managing your Tealium deployment and a powerful framework for creating custom tools or using tools shared by other Tealium users.

Once installed, the Tealium Tools window is organized into the following two tabs:

  • Home
    Contains official Tealium built-in tools.
    Tealium Tools_Browser Extensions.jpg
  • Custom Tools
    Allows you to manage and run custom tools.


The Tealium Tools extension is built for the following browsers:

  • Google Chrome

Official Tealium Tools

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

  • Tealium iQ
    A bookmarked link to the iQ Tag Management interface.
  • TLC (Tealium Learning Community)
    A bookmarked link to the Tealium Learning Community.
  • 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.
  • Scan Companion
    A tool used to scan your site for tags that are not managed through Tealium iQ. Scan Companion is a complementary tool to Site Scan.
  • 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.
  • Verify Test Recorder
    Test Recorder is a Tealium Tool utility built for recording step-by-step workflows like checkout, newsletter sign-up, product views, etc. You record a test by mimicking page views, clicks, or mouseovers in the order that it takes the visitor to complete the workflow.
  • 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/Profile.

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


Tealium Tools is installed using each browser's extension marketplace.

Google Chrome

Use the following steps 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.
    Tealium Tools_Chrome Download Page.jpg
  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.

Managing 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.

Adding a Custom 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 + Custom Tool.
  4. Click the Add Custom Tools tab.
    Tealium Tools Extension_Add Custom Tool.jpg
  5. Copy and paste the JSON URL or JSON definition object into the respective fields.
  6. Click Add Custom Tool.
  7. Click Close.
  8. Click Exit.
    A message displays to confirm that the custom tool was added successfully.
    Tealium Tools Extension_Add Custom Tool_Success Message.jpg
  9. Click Close.
    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.

    Tealium Tools Extension_Add Custom Tool_UTAG Debugger Tool Available for Use.jpg
  10. Click the button for the tool to begin to use.

Removing 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.
    Tealium Tools Extension_Remove Custom Tool.jpg
  6. To remove all custom tools, scroll to the bottom and click Remove All Custom Tools.
  7. Click Close.
  8. Click Exit.


Google Chrome

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.
    Tealium Tools Extension_Remove Entire Extension.jpg
  2. Navigate to the Tealium Tools extension and click Remove.
    Tealium Tools_Chrome Extension_Remove.jpg
    A confirmation dialog displays.
  3. Click Remove again to confirm.

Additional Information

Version history
Last update:
a month ago
Updated by: