CookieConsent v3 Loader
Use the CookieConsent v3 Loader extension to load and configure the open source CookieConsent consent management tool on your site.
The CookieConsent v3 Loader extension lets you implement CookieConsent: CookieConsent v3 through Tealium iQ instead of directly on your site, enabling better control and versioning. It loads the required JavaScript and CSS files and runs your custom configuration to render the consent banner and modal.
Requirements
CookieConsent v3 Loader extension requires the following:
How it works
This extension loads the CookieConsent library and initializes it using a configuration object ccConfig
. You can define categories, services, styles, language settings, and behavior through the extension’s JSON configuration.
The tool is designed to operate in opt-in or opt-out mode and supports advanced features such as disabling page interaction, customizing modal layout, and setting linked categories and cookie tables.
When the page loads, the extension:
- Loads the CookieConsent library.
- Applies your customized
ccConfig
settings. - Displays the consent modal to users based on your preferences.
How to configure
-
In Tealium iQ, go to Extensions and click Add Extension.
-
Click the Privacy tab.
-
Click + Add next to the CookieConsent v3 Loader extension.
-
Enter a Title for the extension.
-
Under Scope, use the default option DOM Ready. It supports load conditions, which lets you control when the extension runs. The Preloader scope is also supported but doesn’t allow load conditions.
-
(Optional) Click Add Condition to apply a load condition for this extension. This is useful for running the banner only in specific scenarios (for example, when a region-specific load rule is true). Ensure the conditions match your consent integration’s enforcement rules to avoid enforcement issues.
-
In the Configuration code, update the
ccConfig
JSON object to define your settings. This includes:- Category definitions such as
necessary
,analytics
, andmarketing
. - Language and translation strings for consent and preferences modals.
- Consent mode:
opt-in
oropt-out
. - GUI options to control banner/modal layout and position.
- Sections and cookie tables in the preferences modal.
- Accessibility-related content such as labels, titles, and button text.
For a full list of configuration options, see CookieConsent: Configuration Reference.
- Category definitions such as
This page was last updated: June 17, 2025