Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Troubleshooting

WordPress Popup Not Working? 9 Causes and How to Fix Them

WordPress Popup Not Working? 9 Causes and How to Fix Them

Short answer

A WordPress popup usually fails because its display rules or cookie settings hide it from you, a caching or optimization plugin delays or breaks its JavaScript, another plugin conflicts with it, or an ad blocker hides it. Test in a private window first, then check the popup's targeting, exclude its script from JavaScript delay, and look for errors in the browser console.

Key takeaways

  • Most popups only show once per visitor, so test in a private window or clear the popup cookie.
  • Delay and combine JavaScript features in caching plugins are a very common cause.
  • Ad blockers and privacy extensions often hide popups on purpose.
  • Check the popup's page rules, devices, triggers and schedule before anything else.
  • The browser console shows the exact script error when a popup breaks.

What exactly is the popup doing wrong?

Name the symptom first, because a popup that never appears, one that appears and cannot be closed, and one that works on desktop only all have different causes.

SymptomMost likely cause
Never shows for you, works for othersYou already saw it; a cookie hides it
Never shows for anyoneDisplay rules, trigger or schedule, or JavaScript blocked
Shows in editor preview, not on the live siteCaching or JavaScript optimization
Shows on desktop, not on mobileDevice targeting or mobile-specific settings
Shows but cannot closeScript error, CSS overlap or theme conflict
Shows behind other contentCSS stacking order (z-index)
Form inside popup does not submitForm plugin conflict or blocked request

Write down where and when it fails before changing settings. That makes the fix much faster.

Have you already seen the popup?

Most popup tools show a popup only once per visitor, then set a cookie to hide it, so test in a private window to see what a new visitor sees.

This catches out many site owners. You open the site, dismiss the popup once, and from then on it never appears for you again.

Open a private or incognito window and visit the page. If the popup shows there, it works; your normal browser is simply remembering that you closed it.

Most popup plugins also skip logged-in administrators by default, or let you turn that on. Check that setting if you test while logged in.

Are the display rules and triggers set correctly?

Check which pages, devices, visitors and dates the popup targets, and what triggers it, such as time on page, scroll depth or exit intent.

Walk through the popup's settings in this order:

  1. Status: published or enabled, not draft
  2. Pages: included on the page you are testing, and not excluded elsewhere
  3. Devices: desktop, tablet and mobile all selected if you want them
  4. Trigger: delay, scroll percentage, click or exit intent
  5. Frequency: how often it can show to the same visitor
  6. Schedule: start and end dates not in the past

Exit-intent triggers rarely fire on phones, because there is no mouse leaving the window. Use a time or scroll trigger for mobile instead.

Is a caching or optimization plugin breaking the popup?

Yes, this is one of the most common causes: features that delay, defer or combine JavaScript can stop the popup script from running until the visitor interacts, or break it entirely.

Test by turning off JavaScript delay and combining in your caching plugin, then purge the cache and reload in a private window. If the popup now works, add the popup plugin's script to the plugin's exclusion list and turn the features back on.

Our guide on WP Rocket delay JavaScript exclusions shows how exclusions work, and the same idea applies to other caching plugins.

Also purge the cache after you edit a popup. A cached page may still contain the old popup settings.

Could another plugin or the theme be conflicting?

Yes, two plugins loading different versions of the same library, or a theme script that fails first, can stop the popup from working.

The safest test is the Health Check & Troubleshooting plugin, which turns off plugins and switches to a default theme only for you. Turn plugins back on one at a time until the popup breaks again.

Our guide to finding which plugin is causing a problem explains this method step by step.

Avoid running two popup plugins at once. They often fight over the same page events and overlays.

Is an ad blocker or browser extension hiding it?

Often yes, because ad blockers and privacy extensions block common popup scripts and class names on purpose, so many visitors will never see some popups.

Test with all extensions off in a private window. If the popup appears, an extension was blocking it.

You cannot control visitors' blockers, but you can reduce the effect. Avoid popup scripts loaded from ad networks, and do not rely on a popup for anything essential, such as legal notices or checkout steps.

Our guide on WordPress not working in Chrome covers other browser-side causes.

A consent banner can block scripts until the visitor accepts, so a popup tagged as marketing may stay hidden for visitors who decline or have not chosen yet.

Check how your consent plugin classifies the popup script. If the popup only shows announcements or forms you need consent-free, set it as necessary or functional, following your own legal advice.

Also avoid showing a popup and a consent banner at the same moment. Visitors faced with two overlays often close both without reading either.

How do you find the script error?

Open the page, press F12, go to the Console tab and reload; red errors naming the popup plugin or another script point straight to the cause.

The Chrome DevTools Console guide explains how to read these messages. Look for files under /wp-content/plugins/ in the error text.

A single error from any plugin can stop later scripts on the page from running, including the popup. Fixing or removing the failing plugin often fixes the popup too.

Copy the error text when you contact the popup plugin's support. It saves several rounds of questions.

Why does the popup appear behind other content or not close?

A popup behind other elements is usually a CSS stacking problem, and one that will not close usually has a script error or an overlapping element covering the close button.

Sticky headers, chat widgets and cookie banners often use high stacking values. Raise the popup's z-index in its settings or custom CSS so it sits above them. MDN explains how z-index and stacking work.

If the close button does nothing, check the console for errors, and check that no invisible element sits over it.

What if the form inside the popup does not submit?

Test the same form on a normal page first; if it works there, caching or script timing inside the popup is the likely cause.

Forms inside popups add an extra layer that can fail. Common causes are a spam protection field that does not load inside the hidden popup, an expired nonce from a cached page, or a JavaScript conflict between the two plugins.

Try these fixes in order:

  1. Test the form on a regular page to confirm it works by itself
  2. Exclude the page or the form's scripts from caching and JavaScript delay
  3. Use the popup plugin's own integration with your form plugin, if it has one
  4. Turn on the form plugin's AJAX submission option

If the form submits but no email arrives, the problem is email delivery rather than the popup.

How do you make popups work better for visitors and SEO?

Show popups after visitors have engaged, keep them easy to close, and avoid covering the main content on mobile as soon as the page loads.

Google's guidance on avoiding intrusive interstitials explains that popups which make content hard to reach can hurt how pages perform in search, especially on mobile.

Good practices:

  • Delay the popup until a visitor has scrolled or spent some time on the page
  • Make the close button large and obvious
  • Show it once per visitor, not on every page
  • Use small banners rather than full-screen overlays on mobile

A popup that works reliably and respects visitors usually converts better than an aggressive one.

Frequently asked questions

Why is my WordPress popup not showing?

You may have already seen it, so a cookie hides it. Other causes are display rules that exclude the page or device, a caching plugin delaying its JavaScript, a plugin conflict, or an ad blocker. Test in a private window first.

Why does my popup work in preview but not on the live site?

The live site is usually cached or optimized. Turn off JavaScript delay and combining, purge the cache and test again, then exclude the popup script from those features.

Why is my popup not working on mobile?

The popup may target desktop only, or use an exit-intent trigger that phones cannot fire. Enable mobile in the device settings and use a time or scroll trigger for mobile visitors.

Do popups hurt SEO in WordPress?

Popups that cover the main content on mobile right after the page loads can hurt search performance. Delayed, easy-to-close popups and small banners are much safer.

Why can't visitors close my WordPress popup?

A JavaScript error, a theme element covering the close button, or a stacking problem with other overlays is usually the cause. Check the browser console and raise the popup's z-index.

Sources

  1. Health Check & Troubleshooting WordPress.org Plugins
  2. Console overview Chrome for Developers
  3. z-index MDN Web Docs
  4. Avoid intrusive interstitials and dialogs Google Search Central

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.