Tealium Pixel Container Tag

The Tealium Pixel Container is a tag that can load up to 8 pixels on the same page. This tag can be used to implement vendor tags that have not yet been added to the Tealium Tag Marketplace.

In most cases where the Pixel Container tag might be used, the Tealium Generic Tag is a better choice that offers more options. The Pixel Container is best used when adding multiple simple tags that use the same load rule.

Tag types

This tag supports two tag types: image and iframe. Identifying the type of tag you are working with is important, so here are some clues to look for when setting up your tag. If the code for your tag matches any of these patterns, then choose the corresponding tag type in the tag configuration.


Image tag code snippets usually contain one of the following:

  • new Image()
  • <img src="https://
  • document.write("<img src=" ... ">");


Iframe tag code snippets usually contain one of the following:

  • document.createElement('iframe')
  • <iframe src="https://
  • document.write("<iframe src=" ... "></iframe");

Tag configuration

First, go to the Tag Marketplace and add the Tealium Pixel Container to your profile.

Tealium Pixel Container Tag

After adding the tag, configure the below settings:

  • Title: The default is Tealium Pixel (or Iframe) Container. You may replace it with a custom name of choice.
  • Type: Select the type of tag.
  • Auto Cache Bust: When enabled, the parameter _rnd will be appended to each pixel URL with a randomly generated value.
  • Cache Bust Name (optional): Specify a custom name for the cache bust parameter.
  • Pixel 1-8: The URL of each pixel to load. Be sure each URL begins with http://, https://, or //.

Dynamic value substitution

This tag supports dynamic value substitution, which allows you to reference data layer variables directly in the Pixel 1-8 configuration fields. This provides the flexibility to create dynamic tag URLs based on your data layer. To use a data layer variable in a pixel URL, reference the variable name by surrounding it with @@. For example, to insert a data layer variable named account_id into the path of the URL, enter a value like this: //example.com/path/@@account_id@@/i.gif

Each type of data layer variable can be substituted using the following prefixes:

  • Universal Data Object - @@variable@@
  • Javascript Page Variable - @@js\_page.variable@@
  • Meta Tag - @@meta.variable@@
  • Querystring Parameter - @@qp.variable@@
  • Cookie Value- @@cp.variable@@

Load rules

Load rules determine when and where to load an instance of this tag on your site.

Data mappings

This tag does not support data mappings. All parameters must be set in the URL of the pixel.

Was this page helpful?

This page was last updated: January 7, 2023