ID Image Ad Popup & Roadblock
ID Image Ad Popup & Roadblock is a lightweight WordPress plugin for showing responsive image popups on your site. You can build unlimited popups, each with its own images, targeting rules, schedule, and analytics…
Use with caution
ID Image Ad Popup & Roadblock works, but test it on a staging site before relying on it in 2026. It runs on 30+ sites, is rated 5/5 and was last updated 2 months ago, and scores 54/100 on our health check.
- Small user base (30+ active installs)
- Very few reviews so far
Daily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where ID Image Ad Popup & Roadblo… stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| ad popup | #24 |
| popup | >100 |
| responsive popup | #63 |
| roadblock | #1 |
| woocommerce popup | >100 |
Version adoption
Share of active sites per release.
Rating breakdown
★★★★★★★★★★ 5 from 1 reviews
About ID Image Ad Popup & Roadblock
From the official readme · v2.1.0Description
ID Image Ad Popup & Roadblock is a lightweight WordPress plugin for showing responsive image popups on your site. You can build unlimited popups, each with its own images, targeting rules, schedule, and analytics tracking.
Whether you are running a flash sale, promoting a new product, capturing leads, or showing a site-wide notice, ID Image Ad Popup & Roadblock gives you full control over when, where, and how each popup appears.
Version 2.0.0 introduced a modernized card-and-tab admin UI, a new Tracking tab for Google Tag Manager and Google Analytics 4, a Mobile Max Width setting, a Show Logo option, and timezone-correct scheduling. Version 2.1.0 hardens the popup on real mobile devices with viewport-bound sizing, a body-scroll lock, a smarter close button position on narrow screens, and higher z-index so no theme header can render above the popup. All existing popups from earlier versions keep working without any changes.
Key Features
Multiple Popups
* Create unlimited popups, each with its own settings.
* Manage everything from the dedicated Popup Ad menu in the WordPress admin.
Modernized Admin UI (new in 2.0.0)
* Rounded pill-tab navigation for Media, Display Rules, Appearance, and Tracking.
* Clean white card layout for every settings section.
* Rounded buttons, consistent input styling, and modern toggle switches.
* Fully backward compatible with popups saved in earlier versions.
Smart Display Rules
* Show on Entire Website, Home Page Only, All Pages, or All Single Posts.
* Target Specific Page(s) or Specific Post(s) using a live search picker.
* WooCommerce: target All Product Pages or Specific Product Page(s) when WooCommerce is active.
* Home Page detection now works reliably with Elementor and custom template setups.
Responsive Image Support
* Separate images for Desktop and Mobile via the native WordPress Media Library.
* Popup is automatically suppressed on a device if no image is set for it.
* Desktop Max Width in pixels (default 900px).
* Mobile Max Width as a percentage of the viewport (new in 2.0.0, default 90%).
Show Site Logo (new in 2.0.0)
* Optional per-popup toggle to display your site logo (from Customizer, Site Identity, Logo) at the top of the popup.
* The logo is scaled responsively so it looks right on any device.
Popup Scheduling
* Independent Start Date and Time and End Date and Time per popup.
* Each date bound is evaluated on its own, set only a start, only an end, or both.
* Timezone-aware (fixed in 2.0.0): dates are now parsed using the WordPress timezone from Settings, General, instead of the server timezone.
Appearance and Behavior
* Configurable Delay Before Opening (default 3 seconds).
* Auto Close After timer, set to 0 to disable (default 15 seconds).
* Customizable Overlay Color and Overlay Opacity.
* Linkable popup image with Target URL (opens in a new tab, rel="noopener noreferrer").
Analytics and Tracking (new in 2.0.0)
* Optional per-popup Tracking tab, with an on/off switch and a unique Popup ID slug.
* When tracking is enabled, the popup link gets an HTML id matching your Popup ID slug, so any existing GTM click trigger or Element Visibility trigger can target it directly with zero GTM changes.
* The plugin also pushes standardized events to window.dataLayer:
* popup_view when the popup appears.
* popup_click when the popup image/link is clicked.
* popup_close when the popup is closed (X, overlay, or auto-close).
* Every event carries popup_id and popup_title. Click events also add link_url. Close events also add close_reason (button, overlay, or auto) and time_shown_ms. Use these in GA4 to filter and report per popup.
Native WordPress Integration
* Built on Custom Post Type, no custom database tables.
* Native WordPress Media Uploader, no third-party dependencies for uploads.
* Automatic one-time data migration from the old single-setting version.
* Clean uninstall (new in 2.0.0), a proper uninstall.php removes all popup posts and plugin options when you delete the plugin.
Use Cases
- Flash sales and limited-time promotions
- New product announcements
- Email list opt-ins and lead capture
- WooCommerce product-specific upsells
- Event announcements and countdowns
- Site-wide notices and alerts
Support
For help, documentation, or bug reports, visit the ID Image Ad Popup & Roadblock Support Page.
Further documentation and usage guides are available at our official documentation.
License
ID Image Ad Popup & Roadblock is licensed under the GPLv2 or later. You can freely redistribute and modify it under the terms of the license.
The full license text is available here: GPLv2 License
Installation
-
Upload the Plugin
- Go to Plugins, Add New, Upload Plugin in your WordPress admin.
- Select the
id-popup.zipfile and click Install Now.
-
Activate
- Click Activate after installation completes.
-
Create Your First Popup Ad
- Go to Popup Ad, Add New Popup Ad in the WordPress admin sidebar.
- Add a title, upload a desktop image (and optionally a mobile image), pick a display rule, then Publish.
-
Optional: Enable Tracking
- Open your popup ad from Popup Ad, All Popup Ads, click the Tracking tab, turn on Enable Tracking, and set a unique Popup ID slug (for example,
homepage_summer_sale). - Add matching Custom Event triggers in Google Tag Manager if you want
popup_view,popup_click, andpopup_closeevents in GA4.
- Open your popup ad from Popup Ad, All Popup Ads, click the Tracking tab, turn on Enable Tracking, and set a unique Popup ID slug (for example,
-
Add More Popup Ads
- Repeat step 3 for each popup ad. Each one has independent settings.
Frequently asked questions
Can I create multiple popups?
Yes. Version 1.2 introduced a Custom Post Type architecture and later versions keep it. You can create unlimited independent popups, each with its own images, display rules, schedule, and tracking, all managed from the Popup Ad menu in your admin sidebar.
Can I use different images for desktop and mobile?
Yes. Upload a desktop image and a mobile image in the Media tab. If one is missing, the popup is automatically hidden on that device so you never see broken images or empty containers.
How does Mobile Max Width work?
It controls the popup width on devices under 768px, as a percentage of the viewport. Default is 90%. Set a lower value if you want smaller popups on phones, or 100% for edge-to-edge.
What does the Show Logo toggle do?
When on, the popup displays your site logo (the one set in Customizer, Site Identity, Logo) above the popup image at the top-left. It uses the current logo automatically, so if you change the logo in the Customizer, the popup updates too.
Can I schedule the popup to appear only on specific dates?
Yes. Set a Start Date and Time, an End Date and Time, or both. Each boundary is evaluated independently, so you can run an end-date-only sunset campaign without setting a start date.
Does the plugin honor my WordPress timezone?
Yes. As of 2.0.0, start and end dates are compared using the WordPress timezone from Settings, General, Timezone. Before 2.0.0 the plugin used the server timezone, which could cause popups to fire early or late on hosts where the two differed.
Can I target specific pages, posts, or WooCommerce products?
Yes. Use the Display Rules dropdown and pick Specific Page(s), Specific Post(s), or (when WooCommerce is active) Specific Product Page(s). A live search picker lets you find items by name without needing to know IDs.
Does it work with WooCommerce?
Yes. When WooCommerce is active, two extra rules appear: All Product Pages and Specific Product Page(s).
Does it work with Elementor and other page builders?
Yes. The Home Page rule was improved in 2.0.0 to reliably detect the site root even on Elementor-built or custom-template homepages that bypass the standard WordPress main query.
How do I track popup interactions in Google Analytics 4?
Open your popup ad from Popup Ad, All Popup Ads, click the Tracking tab, turn on Enable Tracking, and set a unique Popup ID slug. The plugin then pushes popup_view, popup_click, and popup_close events to the browser dataLayer, and also adds an HTML id matching your slug to the popup link so existing DOM-based GTM triggers work. Wire matching Custom Event triggers in GTM and register popup_id as a custom dimension in GA4 to see per-popup reports.
What if I already have a GTM trigger watching a CSS ID like `#technology_popup_ad`?
Just enter that same slug (technology_popup_ad) in the Popup ID field on the Tracking tab. The plugin will output the popup link with that HTML ID, and your existing trigger and tag will fire without any GTM changes.
How does Auto Close work?
Auto Close After (s) sets how many seconds after opening the popup automatically closes. Set it to 0 to disable auto-close entirely and keep the popup open until the visitor closes it.
Can I have multiple popups showing on the same page?
Yes. Every popup is rendered independently. If two published popups both match the current page and current schedule, both will show. Use scheduling and display rules to control which one appears when.
What happens if I had the old single-settings version installed?
The plugin automatically detects your old settings and migrates them into a new popup post called Default Popup on the first admin load after upgrading. No data is lost, no manual steps are needed.
What happens when I delete the plugin?
As of 2.0.0, the plugin ships with a proper uninstall.php that removes all popup posts (Custom Post Type entries and their meta) and clears the plugin’s own options. If you only Deactivate the plugin, your data stays intact.
Is it compatible with popups from earlier versions?
Yes. All 2.x versions preserve every option key, meta key, hook, and shortcode from previous versions. Your existing popups keep their settings and keep working without any manual changes.
Changelog
Mobile hardening: viewport-bound sizing, body-scroll lock, close button repositioned inside popup on narrow screens, higher z-index so sticky headers never overlap. Backward compatible.
2.1.0
Released: August 2026
Mobile Popup Hardening
* Popup on mobile now uses viewport units (vw/vh) instead of percentages so it is always bound to the actual viewport, even on themes that apply a CSS transform to body (Bootstrap, some builders) which previously could stretch or push the layout.
* Enforced overflow-x: hidden inside the popup container on mobile so oversized images cannot spill sideways.
* Enforced img { max-width: 100% } on mobile with priority so the popup image can never exceed the popup width.
* Added a body-scroll lock: while any popup is open, body gets an id-popup-open class that disables page scroll, so tapping the popup cannot accidentally move the page underneath.
* Overlay z-index bumped to 999998 and popup container to 999999 so themes with sticky headers or high-z-index elements cannot render above the popup.
* Replaced the inset: 0 shorthand on the overlay with explicit top/right/bottom/left: 0 for compatibility with older mobile browsers (pre Chrome 87 / Safari 14.1).
* Added -webkit-transform fallback on the popup container for older mobile Safari.
Close Button on Mobile
* On screens under 768px the close (x) button is now positioned INSIDE the popup at the top-right (top 6px, right 6px), instead of hanging off the corner. This prevents the button from being clipped off-screen on narrow phones and keeps it tappable.
Site Logo on Mobile
* When Show Logo is enabled, the logo now scales down on mobile (max-height 36px, max-width 140px) so it does not crowd the popup image on small screens.
2.0.0
Released: August 2026
New Features
* Mobile Max Width (%) setting per popup, controls popup width on devices under 768px as a percentage of the viewport (default 90%).
* Show Logo toggle, displays the site logo from Customizer, Site Identity, Logo at the top of the popup, sized responsively.
* Tracking tab for Google Tag Manager and Google Analytics 4 integration:
* Per-popup Enable Tracking switch and unique Popup ID slug.
* When enabled, the popup link renders with an HTML id matching your slug (works with existing DOM-based GTM click and Element Visibility triggers).
* Standardized events pushed to window.dataLayer: popup_view, popup_click, popup_close.
* Event parameters: popup_id, popup_title, link_url, close_reason (button, overlay, auto), time_shown_ms.
Modernized Admin UI
* New pill-tab navigation on the popup edit screen (Media, Display Rules, Appearance, Tracking).
* Clean white card layout for every settings section, with rounded corners.
* Consistent rounded pill buttons, unified input styling, modern toggle switches, and a matching Publish button.
* Fully backward compatible: all existing option keys, meta keys, hooks, and shortcodes are preserved.
Timezone Correctness
* Scheduling now honors the WordPress timezone from Settings, General, instead of the server timezone. Start and end dates compare correctly across all hosting environments.
Improved Home Page Detection
* The Home Page Only rule now matches WordPress is_front_page() and is_home(), plus a URL-path fallback, so page builders and custom templates that bypass main-query conditionals (Elementor, custom themes) still resolve the site root correctly.
Bug Fixes
* Close button position stays anchored to the popup image top-right corner whether or not the site logo is enabled.
* Close button glyph is now visually centered inside its circle across browsers (Arial fallback plus zero line-height eliminates cross-browser glyph drift).
Housekeeping
* Added uninstall.php that removes all popup posts and plugin options on plugin deletion (multisite-safe).
* Bumped Tested up to to 7.0.
1.5
Released: March 2026
* Updated short description and tags.
* Synchronised plugin version with stable tag.
1.4
Security Hardening
* Added wp_die() after wp_send_json_error() in AJAX handler to prevent continued execution after unauthorized access.
* Whitelisted the type parameter in the AJAX search handler against known post types, unknown types are rejected with wp_die().
* Switched popup_link sanitization from sanitize_text_field() to esc_url_raw(), the correct WordPress standard for URL fields stored in the database.
* Added strict allowlist validation for display_rules using in_array() with type checking.
* Cast all specific_ids to integers using intval, eliminating string injection risk through ID fields.
* Applied esc_html() to post titles and absint() to IDs in AJAX JSON responses.
* Applied esc_attr() to desktop_max_width in inline style output.
Bug Fixes
* Fixed auto-close value of 0 not working. parseInt(0) || 15000 was incorrectly evaluating to 15000. Now uses isNaN() check so 0 correctly disables auto-close.
* Fixed mobile skip logic. data() returns a string but was compared with === 0 (integer). Wrapped with parseInt() for correct type coercion.
* Fixed scheduling logic. Previously required both start AND end dates to evaluate, now each date boundary is checked independently.
* Removed dead $preview_style PHP variable that was computed but never used.
Performance
* Added no_found_rows: true and update_post_term_cache: false to the frontend WP_Query to skip unnecessary database queries.
* Popup HTML is now skipped in PHP entirely if neither desktop nor mobile images are set.
1.3
Released: March 2026
New: WooCommerce Display Rules
* Added All Product Pages display rule, shows the popup on any WooCommerce single product page.
* Added Specific Product Page(s) display rule, target individual products by name using the Select2 search interface.
* WooCommerce rules only appear in the admin dropdown when WooCommerce is active (class_exists('WooCommerce')).
* AJAX search handler supports product post type when specific_products rule is selected.
Select2 Improvements
* Placeholder text updates based on the selected rule: “Search pages…”, “Search posts…”, or “Search products…”.
* Search field also appears for specific_products rule.
Display Rule Precision
* All Single Posts now uses is_singular('post') instead of is_single(), correctly excluding custom post types and WooCommerce products.
* Specific Post(s) uses is_singular('post') + get_queried_object_id() matching, consistent with the specific pages and products pattern.
* Specific Page(s) uses get_queried_object_id() for ID matching instead of passing an array to is_page().
1.2
Released: March 2026
Multiple Popups Architecture (Major Feature)
* Migrated from a single WordPress Options API settings page to a Custom Post Type (id_popup).
* Each popup is now an independent WordPress post with its own title, settings, and lifecycle.
* Dedicated Popups menu item in the WordPress admin sidebar with a custom dashicon.
* Three separate WordPress Meta Boxes replace the single settings form: Media Setup, Display Rules and Scheduling, and Appearance and Behavior.
* Meta box headers styled with the plugin’s red theme.
* Automatic one-time data migration from the old id_popup_settings option into a new “Default Popup” post, no data loss on upgrade.
Frontend Multi-Popup Support
* Frontend uses WP_Query to loop all published id_popup posts.
* Each popup evaluated independently for scheduling and display rules.
* HTML output switched from singleton IDs (#id-popup) to classes (.id-popup-container, .id-popup-overlay) to support multiple popups on one page.
* Per-popup delay and auto-close timings passed via data-delay and data-autoclose attributes, no global JS variables.
Image Handling
* Each popup independently skips rendering if no image is configured for the current device type.
* Device detection (data-has-desktop, data-has-mobile) evaluated fresh per popup per page load.
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.
FAQ
ID Image Ad Popup & Roadblock: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Oct 9, 2026
Is ID Image Ad Popup & Roadblock free?
Yes. ID Image Ad Popup & Roadblock is free to download and use from the official WordPress.org plugin directory.
Is ID Image Ad Popup & Roadblock safe to use in 2026?
ID Image Ad Popup & Roadblock works, but test it on a staging site before relying on it in 2026. It runs on 30+ sites, is rated 5/5 and was last updated 2 months ago, and scores 54/100 on our health check.
How many websites use ID Image Ad Popup & Roadblock?
ID Image Ad Popup & Roadblock is active on 30+ WordPress websites and has been downloaded 1,674 times since it launched in May 2025. It was downloaded 124 times in the last 30 days.
Does ID Image Ad Popup & Roadblock work with WordPress 7.1?
ID Image Ad Popup & Roadblock is officially tested up to WordPress 7.0.7, while the latest release is 7.1.3. It may still work, but try it on a staging site first.
What PHP version does ID Image Ad Popup & Roadblock need?
ID Image Ad Popup & Roadblock requires PHP 7.4 or higher. Most hosts run PHP 8.x today, so it works on any modern WordPress hosting.
When was ID Image Ad Popup & Roadblock last updated?
The latest version, 2.1.0, was released on August 11, 2026 (2 months ago).
Who makes ID Image Ad Popup & Roadblock?
ID Image Ad Popup & Roadblock is developed and maintained by InDesign Media.
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
