AdUnblocker – WordPress plugin | WordPress.org Skip to content WordPress.org Showcase Plugins Themes Hosting News Resources Learn WordPress Documentation Education Forums Developers Blocks Patterns Photos Openverse ↗︎ WordPress.tv ↗︎ About About WordPress Make WordPress Events Five for the Future Enterprise Gutenberg ↗︎ Job Board ↗︎ Swag Store ↗︎ Get WordPress Search in WordPress.org Get WordPress WordPress.org Plugin Directory AdUnblocker Submit a plugin My favorites Log in Submit a plugin My favorites Log in Search plugins AdUnblocker By digitalapps Download Details Reviews Installation Development Support Description AdUnblocker helps publishers understand how ad blocking affects their site and recover visitor support with configurable, accessible messages. The free plugin detects blocked advertising assets, displays the popup you design, and provides a seven-day view of detection and recovery outcomes. AdUnblocker is fully compatible with Gutenberg, so you can build your own popup layouts with familiar WordPress blocks. Analytics stay in your WordPress database and raw IP addresses are never stored. Learn more on the AdUnblocker product page or ask a question in the WordPress.org support forum. Fully Gutenberg compatible Design your own recovery popups in Gutenberg instead of working with a fixed message or raw HTML. Use the native WordPress block editor and combine familiar blocks such as headings, paragraphs, images, buttons, lists, and columns into a custom popup layout. Start from an automatically created, inactive starter popup. Choose strict, temporary, or dismissible behaviour. Control display delay, page or session scope, colours, spacing, width, padding, and border radius. Show a customizable “allow ads and refresh” action. Display a popup across the site or target selected pages. Preview the adblock experience from an authenticated popup action without changing the live campaign. Keep unlimited popup drafts. The free edition allows one published popup at a time. Disable AdUnblocker on individual pages when needed. Measure detection and recovery The free analytics dashboard reports the last seven days of activity: Adblock rate, total detection checks, and blocked checks. Unique blocked visitors and popup viewers. Dismissed and recovered visitors. Recovery and dismissal rates. Daily blocked-versus-not-blocked trends. Per-popup views, recoveries, dismissals, and conversion rates. Visitor identifiers are generated in the browser and stored as salted hashes in WordPress. Raw IP addresses are not stored. Free analytics are automatically pruned after seven days and administrators can clear them at any time. Built for resilient delivery AdUnblocker can regenerate its frontend script and stylesheet with randomized names and selectors. Generated assets are stored in WordPress’s persistent cache directory, with safe fallback to the bundled assets when that location is unavailable. The frontend recovery interface supports keyboard operation, focus management, Escape-key behaviour where dismissal is allowed, and reduced-motion preferences. Pro Add-on AdUnblocker Pro is delivered as a separate add-on and requires the free plugin. Pro adds: Multiple simultaneous active popup campaigns. Editable multi-step recovery journeys. URL, device, browser, and visit-based targeting rules. Weighted A/B experiment variants and variant leaderboards. Offer handoffs for subscriptions, Mailchimp, Kit, and generic webhooks. Recovery funnel reporting. Seven, 30, and 90-day reporting ranges. Device, browser, and page-level analytics. License activation and authenticated add-on updates. External Services AdUnblocker may contact Google’s AdSense service from the visitor’s browser on public pages where ad-block detection is enabled. This external connection supports the plugin’s client-side detection feature; the plugin does not send its analytics records or WordPress account data to Google. The visitor’s browser makes this request directly to Google. Google may receive standard web-request information such as the visitor’s IP address, browser user agent, and referring page. This service is provided by Google under its Privacy Policy and AdSense Terms and Conditions. Screenshots New analytics and recovery dashboard showing seven-day performance metrics. New multi-step recovery journey builder with triggers and targeting controls. Frontend preview of a custom recovery popup designed with Gutenberg. Installation Install AdUnblocker from Plugins > Add New, or upload the adunblocker folder to /wp-content/plugins/. Activate AdUnblocker. Open AdUnblocker > Popups and review the inactive starter popup. Customize and preview the popup, then publish it when ready. Open AdUnblocker > Settings to configure detection and review analytics. For the optional Pro add-on, keep the free plugin active, install and activate adunblocker-pro, then validate the license under AdUnblocker > Pro License. FAQ Does AdUnblocker block ads? No. It detects signs that advertising assets are being blocked, displays your recovery message, and measures visitor responses. What data does the free plugin store? AdUnblocker stores event time and date, event type, adblock status, popup ID, normalized page path, broad device and browser categories, a visit identifier, and a salted visitor hash in your WordPress database. It does not store raw IP addresses. Free analytics are retained for seven days and can be cleared by an administrator. The browser also uses local storage and session storage for random visitor/session identifiers, popup state, and recovery tracking. This data stays in that visitor’s browser unless it is submitted to your own WordPress site as part of an analytics event. Does the plugin send analytics to Digital Apps? No. Free analytics are sent only to your own WordPress installation and remain in its database. The client-side detection feature may contact Google AdSense as described under External Services. Where are generated assets stored? Randomized runtime assets are stored below wp-content/cache/. If WordPress cannot write there, AdUnblocker falls back to its bundled script and stylesheet so the site continues to work. How many popups can I create? The free edition supports unlimited drafts and one published popup at a time. Publishing another popup automatically returns the previously active popup to draft. Pro supports multiple active campaigns. Is AdUnblocker fully compatible with Gutenberg? Yes. AdUnblocker uses the native WordPress block editor for popup creation. You can design your own popup layouts with Gutenberg blocks, configure their behaviour and appearance, preview the adblock experience, and publish them without writing HTML. Where can I get help or report a bug? Use the WordPress.org support forum, contact Digital Apps, or report a reproducible issue on GitHub. Reviews Simple and very useful androtakichi November 19, 2023 Simple and very useful. Great sysguides September 17, 2023 I just installed it. I don’t recall installing it previously. Thus far, so good. Rápido, sencillo y efectivo dicrivero April 25, 2023 Muy bueno Works perfect Martin64 March 10, 2023 I have not had any problems with this plug-in Best adblocker chrishans188 February 13, 2023 It’s very simple and really working Awesom, working great faiqkhan114 June 23, 2022 Awesom, working great. recomended this to others. Read all 33 reviews Contributors & Developers “AdUnblocker” is open source software. The following people have contributed to this plugin.Contributors digitalapps “AdUnblocker” has been translated into 1 locale. Thank you to the translators for their contributions. Translate “AdUnblocker” into your language.Interested in development? Browse the code, check out the SVN repository, or subscribe to the development log by RSS. Changelog 2.0.0 Added block-editor popup management with strict, temporary, and dismissible behaviour. Added full Gutenberg compatibility for designing custom popup layouts with WordPress blocks. Added an inactive starter popup, unlimited drafts, page targeting, and authenticated frontend previews. Added seven-day privacy-friendly analytics for detections, blocked visitors, popup views, dismissals, recoveries, trends, and per-popup performance. Added accessible refresh actions, keyboard focus management, and reduced-motion handling. Added randomized frontend script and stylesheet generation in the persistent WordPress cache directory with bundled-asset fallback. Added the free-core and separate Pro add-on architecture. Added Pro support for multiple campaigns, recovery journeys, targeting rules, experiments, offers, 90-day reporting, and audience breakdowns. Improved blocker-resistant admin analytics asset loading and failure reporting. Confirmed compatibility with WordPress 7.0.1. 1.3.5 Fixed Safari compatibility issues. Meta Version 2.0.0 Last updated 7 days ago Active installations 200+ WordPress version 6.3 or higher Tested up to 7.0.2 PHP version 7.4 or higher Languages See all 2 Close Chinese (Taiwan) and English (US). Translate into your language Tags ad recoveryadblockanalyticsanti-adblockgutenberg Advanced View Ratings 4.8 out of 5 stars. 29 5-star reviews 5 stars 29 2 4-star reviews 4 stars 2 0 3-star reviews 3 stars 0 1 2-star review 2 stars 1 0 1-star reviews 1 star 0 Your review See all reviews Contributors digitalapps Support Got something to say? Need help? View support forum About News Hosting Privacy Showcase Themes Plugins Patterns Learn Documentation Developers WordPress.tv ↗ Get Involved Events Donate ↗ Five for the Future WordPress.com ↗ Matt ↗ bbPress ↗ BuddyPress ↗ WordPress.org WordPress.org Visit our X (formerly Twitter) account Visit our Bluesky account Visit our Mastodon account Visit our Threads account Visit our Facebook page Visit our Instagram account Visit our LinkedIn account Visit our TikTok account Visit our YouTube channel Visit our Tumblr account The WordPress® trademark is the intellectual property of the WordPress Foundation. Close Previous Next