About templates
A template contains the JavaScript code for the core logic of a vendor tag or a component of the consent manager. Each marketplace vendor tag has its own template that converts the tag configuration, data mappings, and extensions from the iQ Tag Management interface into the JavaScript code that runs on your site. And each component of the consent manager has a template that controls its behavior on your site.
There are a number of scenarios where you might need to edit a template, including:
- Updating to the latest release of a vendor tag.
- Updating to the newest features of the consent manager.
- Changing the core logic of a tag.
- Customizing components of the consent manager.
- Fixing a bug in a tag.
Some customizations and fixes can be achieved using an extension scoped to the tag rather than editing the template. This approach should be considered first because it is easier to maintain over time.
Template types
Templates are used for vendor tags, Tealium tags, and the consent manager. When you view a list of templates, each type can be identified by the following names:
- Tealium Tags
- uTag Loader
The template forutag.js
. - uTag Sync
The template forutag.sync.js
. - uTag Footer (deprecated)
The template forutag.footer.js
- uTag Loader
- Consent Manager
- Dom Ready (
cmDomready
) - General (
cmGeneral
) - Show Explicit (
cmShowexplicit
) - Show Preferences (
cmShowpreferences
) - Do Not Sell Banner (
cmShowDNSBanner
) - Do Not Sell Preferences (
cmDoNotSell
) - Do Not Sell Prompt (
cmShowDNSPrompt
) - Consent Logging - Accept/Decline Consent (
fullConsentEventHandler
) - Consent Logging - Grant Partial Consent (
partialConsentEventHandler
)
- Dom Ready (
- Consent Integration
- Framework (
utcm_framework
) - All integration templates are identified by the integration name (as it appears in Tealium iQ Consent Integrations dashboard), the template name (such as OneTrust, Usercentrics, Custom, etc.) and the internal Tealium ID for your instance of that template.
For example:
Consent Integrations - Test Integration (onetrust) UID:utcm_e9582a8f-40fd-49ae-9819-fb2721f5547e
- Framework (
- Marketplace Tags
All marketplace templates are identified by their vendor name (as it appears in the marketplace), tag name (as entered in the tag configuration), and the tag UID.
For example:Twitter Conversions: Twitter Conversions (Retargeting): Tag UID: 2042
Edit template workflow
When you edit or update a template you must apply your changes and then save the profile. If a tag template is changed, the tag will be marked as Updated. If you change a template and don’t save the profile, the changes are discarded.
Access templates
The following methods are available for accessing templates:
- Admin Menu
In the admin menu, click Manage Templates.
This method allows you to browse all templates in the profile and quickly access them from a drop-down list. - Tag Configuration
From the tag configuration screen, expand the Advanced Settings area and click Edit Templates.
This method takes you directly to the template for that tag. - Template Status Checker
In the admin menu, click Template Status Checker then click a template in the report.
This method displays a status report of your templates, including the consent manager templates and the Tealium uTag templates.
Learn more about the template status checker.
This page was last updated: June 27, 2023