Title: WPSP Ad Blocker Alert Author: WP Small Plugins Published: October 13, 2026 Last modified: October 13, 2026 --- Search plugins ![](https://ps.w.org/wpsp-ad-blocker-alert/assets/banner-772x250.png?rev=3744860) ![](https://ps.w.org/wpsp-ad-blocker-alert/assets/icon-256x256.png?rev=3744860) # WPSP Ad Blocker Alert By [WP Small Plugins](https://profiles.wordpress.org/wpsmallplugins/) [Download](https://downloads.wordpress.org/plugin/wpsp-ad-blocker-alert.4.4.4.zip) * [Details](https://wordpress.org/plugins/wpsp-ad-blocker-alert/#description) * [Reviews](https://wordpress.org/plugins/wpsp-ad-blocker-alert/#reviews) * [Installation](https://wordpress.org/plugins/wpsp-ad-blocker-alert/#installation) * [Development](https://wordpress.org/plugins/wpsp-ad-blocker-alert/#developers) [Support](https://wordpress.org/support/plugin/wpsp-ad-blocker-alert/) ## Description **WPSP Ad Blocker Alert** checks whether a visitor’s browser is blocking ads, using two tests (a CSS bait element and a script bait request), and shows a notification popup over blurred page content. #### Features * Detects common ad blockers, including uBlock Origin, AdBlock Plus, Brave Shields and AdGuard * Customizable notification message (HTML allowed) * Blur + popup overlay with adjustable intensity and colors * Permanent or temporary display mode * Whitelist specific URL paths to bypass detection on chosen pages * Random element IDs on every page load, which makes the popup harder for filter lists to target * Inline script delivery: the detection script is printed into the page instead of loaded from a separate file * Test mode: append `?wpsp_ad_blocker_alert_test=1` to any URL to preview without an ad blocker * Debug mode: append `?wpsp_ad_blocker_alert_debug=1` to see a diagnostic overlay #### Upgrade to Pro **[WPSP Ad Blocker Alert Pro](https://wpsmallplugins.com/wpsp-ad-blocker-alert-pro)** adds: * **Polite Notice** — non-blocking top banner instead of a hard popup * **Content Paywall** — hides content below the fold with a gradient gate * **Email Opt-in** — show a newsletter signup form as the gate (Mailchimp integration included) * **Analytics Dashboard** — charts and tables tracking blocked vs clean visits over time * **Consent / GDPR** mode — skip detection if the visitor hasn’t accepted cookies * Export opt-in emails to CSV ## Installation 1. Upload the `wpsp-ad-blocker-alert` folder to `/wp-content/plugins/` 2. Activate the plugin via the **Plugins** menu 3. Go to the **WPSP Ad Blocker Alert** menu item in the main admin sidebar to configure ## FAQ ### Does it work with page caching? Yes. Detection runs in the visitor’s browser, so cached pages are not a problem. ### Which ad blockers are detected? The plugin tests whether typical ad elements and ad scripts are blocked, so it works with common blockers such as uBlock Origin, AdBlock Plus, Brave Shields and AdGuard. No detection method is perfect: a blocker that is configured not to block these tests, or a visitor with the blocker paused for your site, will not be detected. ### Can I test without an ad blocker? Yes. Append `?wpsp_ad_blocker_alert_test=1` to any URL on your site to force the popup to appear. ### Will the popup reappear on every page? Yes. It appears on every page the visitor loads, unless that page is on your Whitelist URLs list. ### Is this plugin Multisite compatible? No, WPSP Ad Blocker Alert is designed for single-site use only. ### Where can I get support? Ask on the [WordPress.org support forum](https://wordpress.org/support/plugin/wpsp-ad-blocker-alert/)— the Support tab in the plugin’s own settings links there too. WPSP Ad Blocker Alert Pro customers get priority support instead of the forum queue. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “WPSP Ad Blocker Alert” is open source software. The following people have contributed to this plugin. Contributors * [ WP Small Plugins ](https://profiles.wordpress.org/wpsmallplugins/) [Translate “WPSP Ad Blocker Alert” into your language.](https://translate.wordpress.org/projects/wp-plugins/wpsp-ad-blocker-alert) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/wpsp-ad-blocker-alert/), check out the [SVN repository](https://plugins.svn.wordpress.org/wpsp-ad-blocker-alert/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wpsp-ad-blocker-alert/) by [RSS](https://plugins.trac.wordpress.org/log/wpsp-ad-blocker-alert/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 4.4.4 * Initial release on WordPress.org. ## Meta * Version **4.4.4** * Last updated **1 day ago** * Active installations **Fewer than 10** * WordPress version ** 5.5 or higher ** * Tested up to **7.1.3** * PHP version ** 7.4 or higher ** * Tags * [ad blocker](https://wordpress.org/plugins/tags/ad-blocker/)[adblock](https://wordpress.org/plugins/tags/adblock/) [adblock detection](https://wordpress.org/plugins/tags/adblock-detection/)[notification](https://wordpress.org/plugins/tags/notification/) [popup](https://wordpress.org/plugins/tags/popup/) * [Advanced View](https://wordpress.org/plugins/wpsp-ad-blocker-alert/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/wpsp-ad-blocker-alert/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/wpsp-ad-blocker-alert/reviews/) ## Contributors * [ WP Small Plugins ](https://profiles.wordpress.org/wpsmallplugins/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/wpsp-ad-blocker-alert/)