Universal Tag Debugger
The Universal Tag (UTAG) Debugger is a tool used for validating the Universal Data Object and event tracking calls.
How it works
The Universal Tag (UTAG) Debugger is a tool used for validating the Universal Data Object and event tracking calls. The UTAG Debugger is similar to Web Companion, with the difference being that it is focused on the data layer and the data captured by each tracking event within
The data objects displayed in the tool are captured after extensions scoped to All Tags - Before Load Rules and before extensions scoped to All Tags - After Load Rules. Learn more about order of operations.
Install the Tealium Tools extension
To use this tool, you must first add it your Chrome browser using the Tealium Tools extension. To install this extension on Chrome or Firefox, see Tealium Tools Browser Extension.
Copy this JSON code. You will paste this into Tealium Tools to add the tool.
Paste JSON to Custom Tools
After you have installed the browser extension, use the following steps to cut and paste the JSON to your Custom Tools:
- Click the Tealium icon in the upper-right of your browser to open Tealium Tools.
- Click the Custom Tools tab.
- From the Custom Tools tab, cut and paste the following JSON code:
- When complete, a new button with the tool name will display under the Custom Tools tab.
Create a bookmarklet
You can optionally create a bookmarklet from which to launch the tool, as follows:
Create a bookmarklet using the following code:
Drag and drop the bookmarklet onto your Bookmarks bar.
Your bookmark is now ready to use.
Using the UTAG Debugger tool
Use the following steps to begin using the UTAG Debugger tool:
- Navigate to your desired website.
- Open Tealium Tools and click the Custom Tools tab.
- Click the Ud button.
The Universal Tag Debugger tool appears.
If you created a bookmark to use, simply click the bookmarklet in your toolbar.
The top section displays which
utag.js file was detected on the page and contains the following:
- the version of
- a number of display options for changing what data will display in the viewing area
The following options are available to help you use and navigate the tool:
- Bookmarklet – You can re-save your display options by dragging the bookmarklet link from the upper-right corner of the popup back to your toolbar.
- Events – The tracking events detected on the page will either be
linkevents, toggle these checkboxes to filter the display.
- Show Data – The UDO data will always be displayed, but additional data sources collected by UTAG can be displayed by toggling these checkboxes.
The following data variables are available:
- iQ – Built-in data collected by
utag.js, including DOM attributes and variables prefixed with
- Cookie – All first party cookies available in the page
- Querystring – Query string variables found in the URL
- Meta – All meta data values available in the page
- AudienceStream – Variables populated by data layer enrichment
Event display area
The event display area automatically updates as you navigate or trigger in-page events. New pages are listed as
utag_view events and in-page events are listed as
The example above shows two pages visited and one event triggered. This results in two
utag_view entries and one
utag_link. The most recent activity always appears at the top.
Thank you for your feedback!
This page was last updated: May 24, 2023