Tiny Simple AdBlock Detector
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…
Solid choice
Tiny Simple AdBlock Detector is a solid plugin choice in 2026, with a few things worth checking first. It runs on 10+ sites and was last updated 5 days ago, and scores 66/100 on our health check.
- Actively developed — last update 5 days ago
- Tested with the latest WordPress (7.1)
- Small user base (10+ active installs)
- Very few reviews so far
How does it stack up?
Side-by-side on installs, updates, ratings & support
Daily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where Tiny Simple AdBlock Detector stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| ad blocker | #80 |
| adblock | #15 |
| ads | >100 |
| content | >100 |
| detect | >100 |
Version adoption
Share of active sites per release.
About Tiny Simple AdBlock Detector
From the official readme · v1.2.2Description
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=1to 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.
Installation
- Install through the WordPress plugin directory, or upload to
/wp-content/plugins/. - Activate the plugin. That’s it — it’s already running.
- Add
class="show-only-when-adblock"orclass="hide-only-when-adblock"to any HTML element. - (Optional) Visit the plugin’s admin page for a quick reference and debug link.
Frequently asked questions
Which ad blockers does it detect?
Tested and confirmed with: uBlock Origin, AdBlock Plus, AdBlock, AdGuard, Brave Shield, and Opera’s built-in blocker. It works by exploiting how ad blockers filter script filenames — so it catches most blockers that follow standard filter lists.
Does it slow down my site?
No. The total JavaScript payload is under 2 KB (two tiny files), loaded asynchronously. It makes zero external HTTP requests. Your PageSpeed score won’t budge.
Is it GDPR compliant?
Yes. The plugin doesn’t collect, store, or transmit any user data. It doesn’t set cookies, fingerprint browsers, or phone home. It’s pure client-side CSS class toggling.
How do I test if it’s working?
Append ?tsad_debug=1 to any page on your site. A debug panel will appear at the bottom showing detection status in real-time. You can also find this link on the plugin’s admin page.
Can I use it with Elementor / Gutenberg / page builders?
Absolutely. Just add the CSS class in your page builder’s “Advanced” → “CSS Classes” field. Works with Gutenberg, Elementor, Divi, WPBakery, Beaver Builder, and any builder that supports custom CSS classes.
What if someone uses a blocker you don’t detect?
The detection relies on ad blockers blocking scripts with “ad-like” filenames (like showads.js). Very aggressive blockers or custom filter lists will definitely get caught. Very minimal or niche blockers might slip through — but those cover a tiny fraction of users.
Can I style the elements differently instead of show/hide?
The plugin uses display: none and display: initial by default. You can override this in your own CSS by targeting .show-only-when-adblock and .hide-only-when-adblock with higher specificity.
Changelog
Maintenance update — reliability fixes and internal cleanup. No behaviour change for your visitors: detection behaves the same, just more reliably on setups where it could silently fail.
1.2.2
- Fixed: ad-blocker detection could fail silently — a JavaScript error could prevent the detection element from being added to the page
- Fixed: several smaller JavaScript issues, including an invalid character in the injected styles and a deprecated property
- Fixed: debug mode (
?tsad_debug=1) was silently off on some server configurations - Improved: the frontend scripts no longer leak global variables that could clash with themes or other plugins
- Improved: all admin and debug messages are now translatable and escaped; the Polish translation was updated
- Maintenance: version number is now read from one place, dead code removed, license info added to the plugin header, and the plugin file can no longer be accessed directly in a browser
1.2.1
- Verified compatibility with WordPress 7.1 (no code changes required)
1.2.0
- Tested and verified with WordPress 7.0
- Fixed hardcoded localhost URL in admin page — now uses dynamic site URL
- Added proper version strings to enqueued scripts for cache busting
- Updated plugin headers (Requires PHP, Requires at least)
- Completely rewritten readme with real-world usage examples
- Added plugin icon and banner
- Added screenshots
- Code cleanup: removed broken .min.js references
1.1.0
- Tested the functionality with the latest version of WordPress
- Improved the UI
- Added more complex testing
1.0.1
- Fixed the bug with the styling for class=”hide-only-when-adblock”
1.0.0
- Initial release
Screenshots
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best Tiny Simple AdBlock Detector alternatives
All ad blocker plugins →
FAQ
Tiny Simple AdBlock Detector: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Oct 12, 2026
Is Tiny Simple AdBlock Detector free?
Yes. Tiny Simple AdBlock Detector is free to download and use from the official WordPress.org plugin directory.
Is Tiny Simple AdBlock Detector safe to use in 2026?
Tiny Simple AdBlock Detector is a solid plugin choice in 2026, with a few things worth checking first. It runs on 10+ sites and was last updated 5 days ago, and scores 66/100 on our health check.
How many websites use Tiny Simple AdBlock Detector?
Tiny Simple AdBlock Detector is active on 10+ WordPress websites and has been downloaded 2,192 times since it launched in July 2016. It was downloaded 176 times in the last 30 days.
Does Tiny Simple AdBlock Detector work with WordPress 7.1?
Yes. The developer has tested Tiny Simple AdBlock Detector up to WordPress 7.1.3, the latest release. It requires WordPress 5.0 or newer.
What PHP version does Tiny Simple AdBlock Detector need?
Tiny Simple AdBlock Detector requires PHP 7.4 or higher. Most hosts run PHP 8.x today, so it works on any modern WordPress hosting.
When was Tiny Simple AdBlock Detector last updated?
The latest version, 1.2.2, was released on October 7, 2026 (5 days ago).
Who makes Tiny Simple AdBlock Detector?
Tiny Simple AdBlock Detector is developed and maintained by Marcin Dudek.
What are the best alternatives to Tiny Simple AdBlock Detector?
The most popular alternatives to Tiny Simple AdBlock Detector are Ad Unblock (100+ installs), Detect AdBlock (20+ installs) and Sorry AdBlocker (10+ installs).
Powered by PageForge
Want thousands of pages that rank like these? Build them in an afternoon.
This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.
- CSV, Google Sheets & API data sources
- AI content, schema & internal links per page
- Works with Elementor, Gutenberg, Yoast & Rank Math
- Free on WordPress.org — no credit card
