Tiny Simple AdBlock Detector

plugin banner

Detects AdBlocking software and allows to display some html based on detection result. Word for AdBlock for sure. Should work for others.

Author:MythThrazz (profile at wordpress.org)
WordPress version required:5.0
WordPress version tested:7.0
Plugin version:1.2.0
Added to WordPress repository:05-07-2016
Last updated:30-03-2026
Rating, %:0
Rated by:0
Plugin URI:https://wordpress.org/plugins/tiny-simple-adb...
Total downloads:1 634
Active installs:10+
plugin download
Click to start download

Over 40% of internet users run an ad blocker. Tiny Simple AdBlock Detector gives you the power to respond — politely ask visitors to whitelist your site, gate premium content, or simply track awareness — all without touching a line of JavaScript yourself.

How it works

The plugin loads a tiny decoy script with a filename that ad blockers love to block. When the script gets blocked, a lightweight CSS class swap kicks in — revealing or hiding any element you’ve marked up. That’s it. No jQuery, no external services, no tracking pixels, no cookie banners.

Two CSS classes. Infinite possibilities.

  • class="show-only-when-adblock" — Element appears only when an ad blocker is active.
  • class="hide-only-when-adblock" — Element disappears when an ad blocker is active.

Add them to any HTML element: a <div>, a Gutenberg block, an Elementor section, a WooCommerce notice — anything.

Real-world examples

  • “Please whitelist us” — Show a polite banner only to ad-blocking visitors
  • Content gating — Hide exclusive articles or downloads from users blocking your ads
  • Alternative monetization — Show a “Support us on Patreon” box only when ads are blocked
  • Analytics — Pair with your analytics tool to track ad-blocker adoption rates on your site

Why this plugin?

  • Zero configuration — Activate it and it works. No settings page, no wizard, no API key.
  • Ridiculously lightweight — Under 2 KB of JavaScript. Your visitors won’t notice.
  • No external requests — Nothing leaves your server. Fully GDPR-friendly.
  • Works with all major ad blockers — uBlock Origin, AdBlock Plus, AdBlock, AdGuard, Brave Shield, Opera built-in blocker.
  • Page builder compatible — Works with Gutenberg, Elementor, Divi, WPBakery, Beaver Builder — anything that lets you add a CSS class.
  • Built-in debug mode — Append ?tsad_debug=1 to any URL to see live detection results.
  • Translation-ready — Includes Polish translation. PRs welcome for others.

From the maker of WP Multi Tool

This plugin is built by the same developer behind WP Multi Tool — the Swiss Army knife for WordPress developers and site administrators. If you manage multiple WordPress sites, check it out.

Screenshots
FAQ
ChangeLog