Use the tags screen to manage your tags. Use these tags in conjunction with load rules to determine when a tag should load.

In this article:

Table of Contents Placeholder

Managing Tags

In the Tealium iQ interface, the tags screen provides the ability to add, load, and configure tags on your websites with just a few simple steps.

Adding a Tag

Use the following steps to add a tag:

  1. Go to iQ Tag Management > Tags.
  2. Click + Add Tag.
    The Tag Marketplace displays.
  3. Locate the tag for a vendor using one of the following methods:
    If you have enabled the Tag Marketplace Policy to show or hide specific tags, the tag marketplace display will vary accordingly. Tags hidden by the policy do not appear in the tag marketplace
    • Search
      Enter the name of the vendor in the text box and click + Add next to the desired tag from the list of results.
    • Categories
      In the sidebar, browse a vendor category, locate your tag in the listing and click + Add.
    • Detect Tag From Code
      Click Detect Tag from Code and enter the code snippet provided by your tag vendor. If the code is recognized, the matching tag will be added with the settings automatically configured.
    • Title/Tag Configuration
      Enter a title for the tag. If you have multiple instances of the same tag, use a descriptive title to distinguish it from the other instances.

      For accounts enabled for Tealium DataAccess, tag titles are included as column values in EventDB; characters for a Redshift database must consist of only UTF-8 printable characters; and ASCII letters are converted to lower case. For detailed information, see Amazon Redshift - Names and Identifiers.

  4. Click Next.
    You are now at the Load Rules tab.
  5. Click + Create Rule.
    The Load Rule dialog displays, which offers built-in evaluating statements and a Data Sources drop-down list from which you can configure a tag to load under precise conditions.

    By default, every profile starts with the default load rule named All Pages. This rule does not contain any conditions, which means it always evaluates to true and any tag configured with this rule will always be loaded.

  6. Enter a descriptive title for your new load rule.
  7. Select a variable from the Select a variable... drop-down list.
  8. In the next drop-down list, select a load rule condition.
    You may select multiple Load Rules for the same tag and assign an AND or an OR rule relationship between multiple Load Rules.
  9. To add more than one load rule condition, use the AND and OR conditional statements.
  10. Click Apply to apply the load rule.
  11. Click Finish again to update the tag.

Viewing the Tag Detail Window

The expanded view of a tag provides a condensed view of tag details, categorized as follows:

Summary View (Left Pane)

Summary information displays in the left pane, including the overall score based on user feedback. From this view, you can copy a tag, delete the tag, or manage labels for the tag.

WhiteUI_TiQ_NewTag_SummaryView.pngDetailed View (Right Pane) Apply Labels
View, add, and manage labels for the tag.

  • Tag Vendor Information
    Displays a brief note about the tag vendor and how the tag is used.
  • Tips
    Provides useful tips and documentation to assist with tag configuration.

Detailed information displays in the right pane, as well as links to edit the tag configuration. From this screen, you can also expand and collapse the tag history view. Detailed information on this screen is categorized by: Tag Configuration, Load Rules, and Mapped/UID, as shown in the following example:

WhiteUI_TiQ_NewTag_SummaryView_Configuration.pngEditing a Tag Configuration
The configuration fields required by the vendor.

  • Load Rules
    Displays the load rule conditions that indicate when and where the tag will load.
  • Mapped Variables
    Displays the variables that are currently mapped to the destination variables for the tag.
  • Related Extensions
    Displays the extensions related to the tag. This includes extensions scoped to the tag, any extension that references a mapped variable, and other extensions such as the Privacy Manager or Tracking Opt-Out.
  • Notes
    Provides space for additional notes about the tag configuration.
  • Mapped and UID
    • WhiteUI_TiQ_MappedAndUIDColumns.pngThe Mapped column displays the number data mappings.
    • The UID column displays the unique identifier for the tag.
      The UID determines the name of the tag configuration file served from the CDN. For example, a tag with a UID of 1878 corresponds to the file utag.1878.js.

Use the following steps to edit a tag:

  1. In the sidebar, select iQ Tag Management > Tags.
  2. Click a tag to expand.
  3. Click the Edit button for the section you want to edit.
    Each section: Tag Configuration, Load Rules, and Mapped Variables, have separate edit buttons that allow you to focus on editing that area.

Turning a Tag On/Off

Tealium recommends deactivating a tag to turn it off without removing it from the list of tags.

Use the following steps to turn off or deactivate a tag:

  1. Click the OFF/ON button to toggle the tag to the OFF position.
  2. Click Save/Publish to save the change.
    This step immediately prevents the tag from loading on any of your pages.
  3. To turn a tag back on, simply click the OFF/ON button again to toggle back to the ON position.

Copying a Tag

Copying a tag is a simple process and is the best method to use to add tags in bulk.

Use the following steps to copy a tag:

  1. Click on a tag to expand the view.
  2. In the sidebar, click Copy....
    The Copy Tag dialog displays.
  3. To create multiple instances of a tag, specify the number of copies you want to make and click Copy Tag.

Deleting or Disabling a Tag

Use the following steps to delete a tag:

  1. Click a tag to expand the view.
  2. Click the Delete button underneath the logo for the tag.
    The Delete Tag dialog displays.
  3. Click Disable Tag or Delete Tag.

    After you edit, delete, or disable a tag, the Save/Publish button displays orange to indicate that you have unsaved changes in the profile.

  4. Click Save/Publish to save the change.

Updating a Tag

Use the Template Status Checker to see when a new version of a tag is available. Update a tag by accessing the tag template. See Tag Templates

Viewing Tag History

Use the following steps to view the history of a tag:

  1. Click View Tag History in the bottom right corner of the expanded tag.
    An expanded view of the history for the tag displays and lists the user that made the change, what the change was, and when the change was made.
  2. Click Hide to collapse the detailed view.

Selecting Publish Locations and Settings

The following sections describe publish locations and details about publish location settings.

Publish Locations

Thee following publish locations are available for every tag:

  • Dev
    The Development (Dev) environment is a non-production environment intended for sandbox configuration.
  • QA
    The Quality Assurance (QA) environment is a non-production environment intended for testing prior to releasing to production.
  • Prod
    The Production (Prod) environment is the environment you intend to load on your live website.

Publish Location Settings

If you select No for any publish locations, the tag will not be published to that location. For example, if you select No for Publish to Prod, the tag will not be pushed to your live site even if you select Prod as a publish target from the Save dialog. This setting helps to prevent the accidental release of tags before they are ready.


If your tags are inexplicably not loading on a page where you expect them and you have verified the load rule logic, the Publish Location settings are the first place to check.

Advanced Settings

The advanced settings are specific configurations for each tag instance. Changing the advanced settings of a tag will not affect other tags. It is important to have a good understanding of the utag.js order of operations before adjusting these settings.

The following image shows the Advanced Settings, as displayed in the interface:


Setting Descriptions
Send Flag

The Send Flag setting determines whether or not a tag sends out data when it loads. The default selection is Yes. If you select No, the tag loads normally but does not send data.

Bundle Flag

The Bundle Flag setting determines whether or not you want to bundle the tag configuration file into utag.js. Tag using the "All Pages" load rule are automatically bundled by enabling the Bundle Tag Loading on All Pages setting in the Publish Configuration.
If your tag uses a custom load rule, you can bundle it by setting this flag to Yes.

The loading order for bundled tags and those using the "All Pages"load rule is determined by the order in which they appear in the Tags tab.

Bundling only affects the iQ Tag Management configuration files ( utag.*.js).

JavaScript library files required by the vendor may still load.

Loading Google Analytics before bundling:


Loading Google Analytics after bundling:



Tag Timing

The Tag Timing setting determines whether a tag loads when the utag.js file loads, or the tag loads when the browser sends the DOM Ready signal. The default setting is DOM Ready (default), meaning the tag does not load until the browsers sends the DOM Ready signal.
Selecting Prioritized means the tag will load without waiting for the DOM Ready signal.

If you load a tag before the DOM Ready signal goes out, you will risk the possibility of a resource or data the tag depends on being unavailable when the tag loads, which can negatively affect tag performance and capabilities.

Synchronous Load

This setting determines whether the tag loads synchronously or asynchronously.

If you intend to load a tag synchronously, you must include the Tealium synchronous utag.js file reference in the source code for the page.

The default setting is No, which means that tag will load asynchronously.

Tealium recommends loading tags asynchronously as a best practice.

Custom Script Source

This setting allows you to support a tag by using an external JavaScript file instead of a built-in tag template.

Enter the URL of the .js file in the Custom Script Source field.

Remove the http: or https: protocol from the URL and use a relative protocol. For example: //

Supporting a tag using a custom JavaScript turns it into a blocking tag, which prevents other tags from running until this tag has finished loading. Though this tag still loads asynchronously, it does not load subsequent asynchronous scripts (e.g. utag.10.js) until the blocking tag is complete.

To load custom JavaScript for a tag without turning the tag into a blocking tag, use the Tealium Generic Tag to load it.

The following table describes each advanced setting and how it is used:

Tag Templates

The template of a tag is the JavaScript code that integrates the vendor code snippet with Tealium iQ. The tag template can be modified for advanced customization or updated to get the latest version of a tag.

To update a tag, see Managing Templates.

Customize a Tag

To edit a tag template:

  1. Click the desired tag.
  2. In the Tag Configuration panel, click Edit.
  3. Scroll down to Advanced Settings and expand the section. Click Edit Templates.
  4. Make your changes and click Apply.
  5. Save the profile.

The use of tag templates is only recommended for advanced users with working knowledge of JavaScript.

Load Order

Tags are loaded in the same order as they appear in your configuration, with the exception of bundled tags.
To change the load order of tags use the Load Order Manager.