• Platforms
  • Partners
  • Forums
  • 日本語
  • TLC Tealium Learning Center Tealium Learning
    Community
  • Discussions & Ideas Dicussions & Ideas
  • Product Guides Product Guides
  • Knowledge Base Knowledge Base
  • Developer Docs Developer Docs
  • Education Education
  • TLC Blog TLC Blog
  • Support Desk Support Desk
  • CDH Customer Data Hub Customer Data Hub
  • Mobile
  • Getting Started
    • Overview
    • Quick Start Guide
    • Mobile Concepts
    • Client-Side
    • Server-Side
    • Tracking Webviews
    • Data Layer
    • Consent Management
    • Event Batching
    • User Location and Geofencing
    • Media Tracking
    • Deep Links
    • Timed Events
    • Trace
    • Hosted Data Layer
    • Adobe Visitor Service Module
    • Feature Comparison
    • Troubleshooting
  • Remote Commands
    • Overview
    • How It Works
    • Integrations
      • Adjust
      • AppsFlyer
      • Branch
      • Braze
      • Contentsquare
      • Facebook
      • Firebase
      • Kochava
      • Usabilla
  • Android (Java)
    • Overview
    • Install
    • Track
    • Data Layer
    • Data Management
    • Consent Management
    • Module List
      • Ad Identifier Module
      • Crash Reporter Module
      • Install Referrer Module
      • Lifecycle Tracking Module
      • Location Module
      • Optimizely X Tracking Module
    • Android TV
    • Android Wear
    • API Reference
      • ConsentManager
      • DataSources
      • Lifecycle
      • Tealium
      • Tealium.Config
      • TealiumLocation
    • Release Notes
  • Android (Kotlin)
    • Overview
    • Install
    • Track
    • Data Layer
    • Consent Management
    • Identity Resolution
    • Module List
      • Ad Identifier Module
      • AutoTracking Module
      • AdobeVisitorService Module
      • Collect Module
      • Collectors Module
      • Crash Reporter Module
      • In-App Purchase Module
      • Install Referrer Module
      • Lifecycle Tracking Module
      • Location Manager Module
      • Media Module
      • RemoteCommands Module
      • Tag Management Dispatcher Module
      • Visitor Service Module
    • Android TV
    • API Reference
      • ConsentCategory
      • ConsentManager
      • CurrentVisit
      • DataLayer
      • Lifecycle
      • LocationManager
      • Media
      • Tealium
      • TealiumConfig
      • VisitorProfile
      • VisitorService
    • Release Notes
  • Cordova 1.x
    • Overview
    • Install
    • Track
    • Data Management
    • Module List
      • Ad Identifier Module
      • Crash Reporter Module
      • Install Referrer Module
    • API Reference
    • Release Notes
  • Cordova 2.x
    • Overview
    • Install
    • Track
    • API Reference
    • Release Notes
  • Flutter 1.x
    • Overview
    • Install
    • Track
    • Consent Management
    • Data Management
    • API Reference
    • Release Notes
  • Flutter 2.x
    • Overview
    • Install
    • Track
    • Consent Management
    • Data Management
    • API Reference
      • Tealium
      • TealiumConfig
      • VisitorProfile
    • Release Notes
  • iOS (Objective-C)
    • Overview
    • Install
    • Track
    • Data Layer
    • Data Management
    • Consent Management
    • Tag Management
    • Module List
      • Lifecycle Tracking Module
    • tvOS
    • watchOS
    • API Reference
    • Release Notes
  • iOS (Swift) 1.x
    • Overview
    • Install
    • Track
    • Data Layer
    • Data Management
    • App Extensions
    • Identity Resolution
    • Consent Management
    • Modules
    • Module List
      • AppData Module
      • Attribution Module
      • AutoTracking Module
      • Collect Module
      • Connectivity Module
      • CrashReporter Module
      • DataSource Module
      • DefaultStorage Module
      • Delegate Module
      • DeviceData Module
      • DispatchQueue Module
      • FileStorage Module
      • Lifecycle Module
      • Location Module
      • Logger Module
      • PersistentData Module
      • RemoteCommands Module
      • TagManagement Module
      • VisitorService Module
      • VolatileData Module
    • Feature Comparison
    • Working with Objective-C
    • API Reference
      • TealiumConfig
      • TealiumConsentCategories
      • TealiumConsentManagerDelegate
      • TealiumConsentManager
      • TealiumInstanceManager
      • TealiumPersistentData
      • TealiumVolatileData
      • Tealium
    • Release Notes
  • iOS (Swift) 2.x
    • Overview
    • Install
    • Track
    • Data Layer
    • Consent Management
    • App Extensions
    • Identity Resolution
    • Modules
    • Module List
      • AppData Module
      • AdobeVisitorService Module
      • Attribution Module
      • AutoTracking Module
      • Collect Module
      • Connectivity Module
      • CrashReporter Module
      • DeviceData Module
      • In-App Purchase Module
      • Lifecycle Module
      • Location Module
      • Media Module
      • RemoteCommands Module
      • TagManagement Module
      • VisitorService Module
    • Working with Objective-C
    • API Reference
      • LocationModule
      • MediaSession
      • Tealium
      • TealiumConfig
      • TealiumConsentCategories
      • TealiumConsentManager
      • TealiumDataLayer
      • TealiumInstanceManager
    • Release Notes
  • NativeScript
    • Overview
    • Install
    • Track
    • API Reference
      • Tealium
      • TealiumConfig
    • Release Notes
  • React Native 1.x
    • Overview
    • Install
    • Track
    • API Reference
    • Release Notes
  • React Native 2.x
    • Overview
    • Install
    • Track
    • Location Module
    • API Reference
    • Release Notes
  • Unity 1.x
    • Overview
    • Install
    • Track
    • API Reference
  • Unity 2.x
    • Overview
    • Install
    • Track
    • API Reference
  • Xamarin 1.x
    • Overview
    • Install
    • Track
    • Data Management
    • Consent Management
    • API Reference
    • Release Notes
  • Xamarin 2.x
    • Overview
    • Install
    • Track
    • Data Layer
    • Consent Management
    • API Reference
    • Release Notes
  • Web
  • Getting Started
    • Overview
    • Quick Start Guide
    • Web Concepts
    • Data Layer
      • An Introduction to the Data Layer
      • How the Data Layer Works for Websites
      • Data Layer Best Practices
      • Definitions
        • Retail
        • Publisher
        • Hotel
        • Travel
        • Basic Video Tracking
  • Adobe Launch
    • Overview
    • Install
    • Data Layer
  • AMP
    • Overview
    • Install
    • Track
    • Data Layer
  • Angular
    • Overview
    • Install
    • Track
    • API Reference
  • Google Tag Manager
    • Overview
    • Install
    • Data Layer
  • JavaScript (Web)
    • Overview
    • Install
    • Track
    • Data Layer
    • Universal Data Object (utag_data)
    • Universal Tag (utag.js)
    • Data Layer Object (b)
    • Single-Page Applications
    • Settings
    • Debugging
    • API Reference
      • Cookie Functions
      • GDPR Functions
      • Tracking Functions
      • Utility Functions
    • Release Notes
  • Server
  • C#
    • Overview
    • Install
    • Track
    • Data Layer
    • API Reference
    • Release Notes
  • HTTP API
    • Overview
    • Endpoint
    • Data Layer
  • Java
    • Overview
    • Install
    • Track
    • API Reference
    • Release Notes
  • Node
    • Overview
    • Install
    • Track
    • API Reference
  • Python
    • Overview
    • Install
    • Track
    • API Reference
  • Roku
    • Overview
    • Install
    • Track
    • API Reference
  • Ruby
    • Overview
    • Install
    • Track
    • API Reference
JAVASCRIPT

Settings

Learn about the available settings that adjust the behavior of utag.js.

How It Works

Many of the behaviors of utag.js are controlled with settings set in the utag.cfg object. The default behaviors controlled by these settings are overridden using a new object called utag_cfg_ovrd. To use this object, set it in your page code prior to loading utag.js or within a JavaScript Code Extension scoped to Pre Loader with the following:

window.utag_cfg_ovrd = window.utag_cfg_ovrd || {};

Settings

The following table summarizes the available settings:

Setting Description
cmcookiens Consent management cookie name.
consentPeriod Set the number of days to retain the user’s consent preference.
dom_complete Delay tags until the DOM complete (load) event.
domain Override the domain used to set cookies.
gdprDLRef Specify the name of the data layer variable which stores the language setting to be used by the consent manager.
load_rules_ajax Disable load rules after page load (legacy).
load_rules_at_wait Run load rules after extensions (legacy).
lowermeta Lower-case meta tag names and values (legacy).
lowerqp Lower-case query string parameter names and values (legacy).
noload Disable all functionality.
noview Disable the automatic tracking call on initial page load.
nocookie Disable the utag_main cookie.
readywait Halt operations until the DOM-ready browser event.
secure_cookie Set the attribute string to secure for all utag_main cookies set by the Persist Data Values extension and the SC() function.
session_timeout Set the session expiration time (in milliseconds).
waittimer Set a time to delay (in milliseconds) before loading tags.

cmcookiens

Consent Management cookie name
Customize the Consent Management cookie name, which is useful when different profiles share the same domain name.

window.utag_cfg_ovrd.cmcookiens = "CONSENTMGR_NL-CMB-CG1";

consentPeriod

Consent preference retention period
Set the number of days to retain GDPR and CCPA consent status. The built-in expiry is 365 days for GDPR and 395 days for CCPA.

window.utag_cfg_ovrd.consentPeriod = 60;

dom_complete

Delay tags until the DOM complete (load) browser event
Load tags at the document load event rather than at DOM Ready.  This also holds back any extensions scoped to DOM Ready.  (Default: false)

window.utag_cfg_ovrd.dom_complete = true;

domain

Override cookie domain
Sets the domain where utag_main cookie is set. Useful for sites on root domains that won’t accept cookies. For example, amazonaws.com. (Default: The top-level domain of location.hostname)

window.utag_cfg_ovrd.domain = "mysite.amazonaws.com";

gdprDLRef

Override language preference in consent manager
Specify the name of the data layer variable which stores the language to be used in the consent manager.

For example, if your data layer contains a variable named site_language:

window.utag_cfg_ovrd = window.utag_cfg_ovrd || {}
window.utag_cfg_ovrd.gdprDLRef = "site_language";

Do not set the language code directly. This override setting expects a variable name, not a language code value.

load_rules_ajax

Disable load rules after page load (legacy)
Controls if load rules are reprocessed on each call to utag.view and utag.link within the same page load. It’s possible that a newly triggered Load Rule loads a new tag into the page. Use this setting to replicate behavior from versions of utag.js older than 4.2x. (Default: true)

window.utag_cfg_ovrd.load_rules_ajax = false;

load_rules_at_wait

Run load rules after extensions (legacy)
Evaluates Load Rules after extensions. Used for older versions of utag.js and for installations where the data layer object is populated after loading utag.js. Newer versions of utag.js make use of extension execution order instead of this setting. (Default: false)

window.utag_cfg_ovrd.load_rules_at_wait = true;

lowermeta

Lower-case meta tag data (legacy)
Lower-case all meta data variable names and values. Replicates behavior in utag.js versions prior to 4.2x. (Default: false)

Example meta tag:

<meta content="iQ Tag Management" property="Article:Section">

Resulting value:

utag.data['meta.article:section']="iq tag management"
window.utag_cfg_ovrd.lowermeta = true;

lowerqp

Lower-case query string parameter names and values (legacy)
Lower-case all query string variable names and values. Replicates behavior in utag.js versions prior to 4.2x. (Default: false)

Example query string parameter: &RefId=Abc123 Resulting value: utag.data['qp.refid']="abc123"

window.utag_cfg_ovrd.lowerqp = true;

noload

Halt all operations
The execution of all code halts after the extensions scoped to Pre Loader. Extensions scoped to DOM Ready still run. This is normally adjusted using the publish setting for Prevent Tag Load. (Default: 0)

window.utag_cfg_ovrd.noload = true;

noview

Disable automatic tracking call on initial page load
Suppresses the tracking call that occurs automatically on initial page load. This setting is commonly used on single page application sites. (Default: false)

window.utag_cfg_ovrd.noview = true;

nocookie

Cookie opt-out
Only set this option if a visitor has explicitly opted out of all cookies. (Default: false)

Using this option inflates visitor and session counts, making all visits look like “single page sessions”.

This option disables all cookies from being stored by utag.js, including cookies set with the Persist Data Value extension, and session cookies. It also sets a new timestamp for the variables ut.visitor_id, tealium_visitor_id, and cp.utag_main_v_id when the cookie is not available.

window.utag_cfg_ovrd.nocookie = true

readywait

Delay operations until DOM-ready
Halt all operations until the DOM-ready signal is received from the browser. Extensions scoped to Pre Loader still run when utag.js loads. (Default: 0)

window.utag_cfg_ovrd.readywait = true;

secure_cookie

Secure cookie
Set the attribute string to secure for all utag_main cookies set by the Persist Data Values extension and the SC() function. Secure cookies can only be set and accessed on HTTPS pages. (Default: false)

Requires utag.js version 4.48

window.utag_cfg_ovrd.secure_cookie = true;

session_timeout

Session timeout
Sets how long to wait, in milliseconds, before expiring the current session. This is normally adjusted using the publish configuration setting for Session Timeout. (Default: 1800000 (30 minutes))

Example to set the timeout to 900000 milliseconds (15 minutes):

window.utag_cfg_ovrd.session_timeout = 900000;

waittimer

Delay tags with timer
Sets how long to wait (in milliseconds) after the DOM Ready event before loading tags. (Default: not set)

window.utag_cfg_ovrd.waittimer = 1000;
"Single-Page Applications "
Previous
Single-Page Applications
Next
Debugging
"Debugging"

 

Was this article helpful?

This page was last updated: January 19, 2022      

Thank you for your feedback!

Table of Contents

  • How It Works
  • Settings
    • cmcookiens
    • consentPeriod
    • dom_complete
    • domain
    • gdprDLRef
    • load_rules_ajax
    • load_rules_at_wait
    • lowermeta
    • lowerqp
    • noload
    • noview
    • nocookie
    • readywait
    • secure_cookie
    • session_timeout
    • waittimer
  • Platforms
  • Partners
  • Forums
  • Mobile
  • Getting Started
  • Remote Commands
  • Android (Java)
  • Android (Kotlin)
  • Cordova 1.x
  • Cordova 2.x
  • Flutter 1.x
  • Flutter 2.x
  • iOS (Objective-C)
  • iOS (Swift) 1.x
  • iOS (Swift) 2.x
  • NativeScript
  • React Native 1.x
  • React Native 2.x
  • Unity 1.x
  • Unity 2.x
  • Xamarin 1.x
  • Xamarin 2.x
  • Web
  • Getting Started
  • Adobe Launch
  • AMP
  • Angular
  • Google Tag Manager
  • JavaScript (Web)
  • Server
  • C#
  • HTTP API
  • Java
  • Node
  • Python
  • Roku
  • Ruby