Splash Popup lets you display targeted modal popups on your WooCommerce store. Create any number of popups, each with its own content, display conditions, trigger behaviour, schedule, and appearance. Popups are evaluated in priority order — the first one that matches the current visitor and page is shown.
Installation
↑ Back to topTo install this extension, follow our installation instructions.
Adding a popup
↑ Back to topGo to WooCommerce → Popups in your WordPress admin and click Add new. This opens the popup editor where you can configure all settings before publishing.
When you’re ready for the popup to appear on your store, set its Status to Published and click Save.
Popup editor overview
↑ Back to topThe editor is divided into a header area (title, status, priority) and six tabs: Content, Conditions, Triggers, Schedule, Appearance, and Stats.
Title, status, and priority
↑ Back to topTitle
↑ Back to topA name for your own reference. Not shown to visitors. Use something descriptive like Welcome discount or Free shipping — Europe.
Status
↑ Back to top- Published — the popup is active and will be shown to visitors who match its conditions.
- Draft — the popup is saved but will not be shown on the frontend. Useful when building a popup you’re not ready to launch yet.
Priority
↑ Back to topA number (default: 10) that controls which popup wins when more than one matches the same visitor and page. Lower numbers have higher priority — a popup with priority 1 will be shown before one with priority 10. Use this to ensure more specific popups take precedence over general ones.
Content tab
↑ Back to topEdit popup content
↑ Back to topClick Edit Popup Content → to open the WordPress block editor, where you can design the popup’s layout and copy using any blocks you’d like — paragraphs, images, buttons, columns, and so on. When you’re done, use the ← Back to popup settings link in the admin bar to return to the popup editor.
Start from a template
↑ Back to topIf your popup is empty, you can pick a pre-built template to start from. Clicking a template opens the block editor with the layout pre-loaded. Available templates include:
- Coupon code — display a discount code
- Newsletter signup — capture email addresses
- Flash sale — promote a time-limited offer
- Feedback — collect visitor feedback
- Exit intent — engage visitors who are about to leave
- Free shipping — announce a free shipping threshold
Applying a template replaces any existing popup content.
Conditions tab
↑ Back to topConditions control who sees the popup and on which pages.
Who sees it
↑ Back to topUser status — choose who the popup is shown to:
- All visitors — shown to everyone, regardless of login state.
- Logged-in users only — only shown to visitors who are signed in. You can optionally restrict this further by selecting one or more user roles (e.g. Customer, Subscriber).
- Logged-out visitors only — only shown to visitors who are not signed in.
Which pages
↑ Back to topPage targeting — choose where the popup can appear:
- All pages — the popup is eligible on every page of your store.
- Specific contexts — restrict the popup to particular areas of your site. You can combine multiple contexts:
- Pages — standard WordPress pages (optionally narrow to specific pages)
- Posts — WordPress blog posts (optionally narrow to specific posts)
- Shop — the main WooCommerce shop archive page
- Cart — the cart page
- Checkout — the checkout page
- Product pages — individual product pages (optionally narrow to specific products)
- Product categories — product category archive pages (optionally narrow to specific categories)
- Search results — search results pages (optionally narrow to a specific search term)
When you choose a context that supports narrowing (product pages, product categories, pages, posts), a search field appears so you can target specific items. Leave it empty to match all items of that type.
Device
↑ Back to topControl which device types see the popup. All three are enabled by default:
- Desktop — screens wider than 1024px
- Tablet — screens between 768px and 1024px
- Mobile — screens narrower than 768px
Uncheck any device type to exclude it.
Geo targeting
↑ Back to topRestrict the popup to visitors from specific countries. Enable country targeting, then select one or more countries from the list.
Geo targeting requires WooCommerce’s MaxMind Geolocation integration to be configured in your store. It will not work in local development environments.
Triggers tab
↑ Back to topTriggers control when the popup fires on a page, and how often it can reappear.
Trigger
↑ Back to topFire popup when — choose what causes the popup to open:
- Page load — fires automatically after the page loads. Set a Delay (seconds) to wait before showing the popup (0 = immediately).
- Scroll depth — fires when the visitor scrolls a certain percentage of the page. Set the Scroll depth (%) using the slider (1–100%).
- Cart total reached — fires on the cart page once the visitor’s cart total reaches or exceeds the Minimum cart total you set. Make sure your page targeting includes the cart page.
- Product added to cart — fires when a product is added to the cart. By default any product triggers it; disable Any product triggers this popup to specify a list of particular products.
- Exit intent — fires when the visitor moves their cursor toward the browser’s close button or address bar, suggesting they are about to leave.
Cookie & display
↑ Back to topCookie expiration (days) — after a visitor dismisses the popup, it won’t reappear for this many days. Set to 0 to use the global default (configured in WooCommerce → Settings → Splash Popup). This prevents the same popup from repeatedly appearing to the same visitor.
Schedule tab
↑ Back to topScheduling lets you restrict the popup to a specific date and time window, useful for seasonal promotions, flash sales, or timed announcements.
Enable Enable date range, then set:
- Start date / time — the popup won’t show before this point.
- End date / time — the popup won’t show after this point.
Dates and times use your site’s configured timezone, shown at the top of the tab. You can set only a start, only an end, or both. Disable the toggle to remove scheduling and let the popup run indefinitely.
Appearance tab
↑ Back to topBy default, all popups inherit the store-wide visual defaults set in WooCommerce → Settings → Splash Popup. Enable Override global defaults for this popup to customise the appearance for this popup specifically.
Modal size
↑ Back to topThe width of the popup modal:
- Small — 400px wide
- Medium — 600px wide
- Large — 800px wide
- Fullscreen — covers the entire screen
Animation
↑ Back to topHow the modal enters the screen:
- Slide up — slides in from the bottom
- Fade — fades in from transparent
- Zoom — scales in from the centre
- Scale — similar to zoom with a slight size change
Overlay opacity
↑ Back to topControls how dark the background overlay is when the popup is open. Range: 0 (transparent, content still fully visible behind) to 1 (fully opaque black overlay). Default is 0.5.
Content padding
↑ Back to topThe amount of whitespace (in pixels) between the popup border and the content inside. Adjust in steps of 4px (0–120px).
Close button colours
↑ Back to top- Close button icon color — the colour of the × icon.
- Close button background — the background colour of the close button.
Stats tab
↑ Back to topThe Stats tab shows view data for the current popup. The following counts are displayed:
- Total views — all-time view count
- Today — views recorded today
- Yesterday — views recorded yesterday
- Last 7 days — rolling 7-day total
- Last 30 days — rolling 30-day total
- Last 365 days — rolling 365-day total
A bar chart of daily views over the last 30 days is shown alongside the summary.
Use the Reset stats button to clear all view counts for this popup. This cannot be undone.
Test mode
↑ Back to topThe Test mode toggle is available at the bottom of the editor, next to the Save button. When enabled, the popup will appear even for visitors who have already dismissed it (the usual cookie check is bypassed). This is useful when building or reviewing a popup. Remember to turn it off before leaving the popup in production.
Global settings
↑ Back to topGlobal settings apply to all popups unless overridden at the individual popup level. Find them at WooCommerce → Settings → Splash Popup.
| Setting | Description |
|---|---|
| Cookie expiration | Default number of days before a dismissed popup can reappear (default: 30) |
| Modal size | Default popup width (Small / Medium / Large / Fullscreen) |
| Animation | Default entrance animation |
| Overlay opacity | Default background overlay darkness |
| Content padding | Default inner padding of the popup content area |
| Close button icon color | Default close button icon colour |
| Close button background | Default close button background colour |
