Skip to main content

Autoblocker overlays for visible embedded content

Updated

Overlays let you display an accept prompt directly on blocked embedded content, so visitors can unblock individual elements without leaving the page.

Before You Begin:

  • You must have the Autoblocker script already installed on your site.

  • This feature supports Google Maps, YouTube, and Facebook Video embeds, as well as the following HTML elements: IFRAME, IMG, EMBED, VIDEO, AUDIO, SOURCE

Steps:

  1. Open the source code of the page or template where your Autoblocker script tag is placed.

  2. Locate the Autoblocker <script> tag.

  3. Add the attribute data-enable-overlays="true" to the script tag. 

    e.g  <script src="your-autoblocker-script.js" data-enable-overlays="true"></script>

  1. Save and publish your changes.

  2. Load a page that contains a blocked embed to confirm the overlay appears.

Screenshot 2026-04-22 at 10.57.14.png

 

What to Expect:

When a visitor lands on a page with a blocked embed, they see an overlay on top of the content. The overlay contains two buttons:

  • Accept: accepts only the services required to unblock that specific piece of content, then immediately displays it.

  • More Information: opens a modal listing every service that is currently blocking the content, so the visitor can review before deciding.

Once the visitor clicks Accept, the embed loads in place without a page reload.

 

Troubleshooting:

The overlay does not appear on my embeds. Confirm that data-enable-overlays="true" is on the Autoblocker <script> tag itself, not on the embed element. Clear your cache and reload.

The overlay appears but the content does not load after clicking Accept. Check that the embed type corresponds to the following html elements: IFRAME, IMG, EMBED, VIDEO, AUDIO, SOURCE

The modal opened by “More Information” is empty. This usually means the Autoblocker has not detected any blocking services for that element. Verify that the embed is correctly flagged in your service configuration.

The overlay is not appearing on mobile devices. Ensure your page does not override the Autoblocker script with a separate mobile template that lacks the data-enable-overlays="true" attribute.