Dynamic Content Blocking
Dynamic Content Blocking allows a visitor to enable content on your page while rejecting consent in general. A typical scenario is blocking of YouTube Videos on a website:
YouTube Video in blocked mode:
The same YouTube Video once the visitor clicked on accept:
Types for dynamic content blocking
- YouTube
- Vimeo
- Google Maps
- OpenStreetMap
- TikTok
- iFrames/IMG/video/...
Requirements
Dynamic content blocking only works with content on your website that is prepared to be blocked and contains a vendor-ID (data-cmp-vendor="...").
IFrame codes
In addition to the above requirements, if the blocked content is an IFrame element, the IFrame needs to have a width an height set and needs to have a minimum size of 300x300 pixels. For IFrames with a smaller size, you must set data-cmp-preview="XxY" in order to get a preview.
Script codes
In addition to the above requirements, if the blocked content is a script element, you need to add the attribute data-cmp-preview="400x300" (where 400x300 is the width and height of the preview element).
Example with Google Maps:
https://help.consentmanager.net/link/73#bkmrk-google-maps-via-api
Automatic preview image
An automatic preview image is shown for YouTube, Vimeo and Google Maps in embed mode (/maps/embed?pb=...).
The dynamic content blocking preview includes two consent controls that work in different ways:
This dual logic lets the visitor choose between a one-off unblock and a persistent "always allow" for that vendor, without reopening the main consent layer.
Important: if you leave the Checkbox text field empty in the design settings, the checkbox is not rendered. Visitors can then only use the button, which grants consent for the current iframe instance, and they lose the ability to allow all iframes of that vendor in one click. We strongly recommend filling in this field (e.g. "Always accept [vendorname]", where [vendorname] is automatically replaced with the actual vendor name).
Changing texts, background and other preview settings
You can adjust the texts and styling of the preview in your login area under Designs > [your design] > Texts, then select your preferred language and scroll to the Preview block.
The available fields are:
- Headline: title shown at the top of the preview (default: "We need your approval").
- Description: explanatory text below the headline. Supports the [vendorname] placeholder, which is automatically replaced with the actual vendor name.
- Button: label of the consent button (default: "Accept").
- Checkbox: label of the "always allow" checkbox (e.g. "Always accept [vendorname]"). Leave this field non-empty to render the checkbox — see the warning above.
Repeat this configuration for every language you support. Otherwise, visitors browsing in a non-default language see a preview with a missing checkbox.
Per-element overrides
You can also override these texts on individual elements using HTML attributes:
- data-cmp-preview-headline="..."
- data-cmp-preview-text="..."
- data-cmp-preview-btn="..."
- data-cmp-preview-checkbox="..."
See the full attribute reference in How to block third-party codes & cookies if no consent is given
