Wisp
Getting Started
Product Tour
The Campaign Builder
Meet Wisp
Discounts
The Campaigns Page
The Wisp Notification
The Notification Feed
Installing Wisp on your website
Custom Setup Guides for Shopify Themes
Minimal Theme
Dawn theme
Narrative Theme
Debut Theme
Simple Theme
Express Theme
Venture Theme
Brooklyn Theme
Boundless Theme
Supply Theme
Installing Wisp with Google Tag Manager
Install Wisp for Shopify
Installing Wisp Manually
Embedding the Wisp Feed
Advanced Feed Customization
Set up Goal Tracking for Wisp
Campaign Strategy
Configure Custom Properties for Wisp
Managing Your Account
Integrations
Wisepops
Getting Started
๐ Meet Wisepops
โ Add Wisepops to Your Website
โจ How to create your first welcome popup
๐ Connect Wisepops to Your Email Service Provider
๐ฑ Design Mobile Popups
๐ค Best practices for popups
Campaign Builder
Design Your Campaign
Write Your Own CSS Rules into Your Popups
Create a Spin-to-Win Campaign
How To Create an Embed
Design FAQ
Create a Thank You Message (or Display a Coupon) After Sign-Up
Use a Custom Font in Your Campaign
How to Use the Custom Position for Bars
Closing Options
Blocks
Custom code
Insert social widgets into your popups
Embed a SurveyMonkey Quiz Into a Popup
Embed a Typeform in Your Popup
How to add a Video to a pop-up?
Tab
JavaScript
Events documentation
Introduction to JS Callbacks
After-popup-close Event
After-tracked-click Event
After-form-submit Event
Before-form-submit Event
Before-popup-display Event
Before-tab-display Event
Before-tracked-click Event
Generic examples
Stop Displaying a Campaign When the Cross Close Icon Is Clicked
Dynamically Add a Custom Parameter to a Redirect URL
Fire the Facebook Pixel When a form is Submitted
Forbid Disposable Emails in Your Signup Form
Display a Popup Only After Another One Has Been Seen (or Clicked)
Forbid Free Emails in Your Signup Form
Create a Spin-the-Wheel Popup Without Collecting the Userโs Email Address
Add a coupon to the clipboard after signup
Create a Micro-Commitment Popup
Add Custom Validation to Your Signup Forms
Flag a Popup as Clicked With JS Code
Display a form field conditionally
Close a Popup With JS Code
Send the data collected by a form to the redirected URL
Display Scenario Settings
Triggers
Target a Popup To Display on Link Click
Target a Popup To Display on Hover
Trigger a Popup When Your Visitors Press the Back Button
Adding a delay to your popup
Create an Exit Popup
Set Custom Events to Trigger Popups
Audience Targeting
How To Test Your Geotargeted Popups
Chromeโs Update and Its Impact on Source URL Targeting
Target a Specific Campaign
Exclude Your Existing Subscribers
Target or Exclude a Specific Country, Region or City
Custom & Ecommerce Properties
Set up Custom Properties for Wisepops
How To Test Your Custom Properties
Shopify Built-In Properties
How to Target (or Exclude) Visitors Who Have Seen a Specific URL
Use Google Tag Manager Variables as Custom Properties
Use Shopify Liquid Variables as Custom Properties
How To Retarget Visitors Who Saw a Specific Page on Your Website
Set Custom Properties Based on Cookie Values
Default Custom Properties in Magento
Display a Popup Based on an Alexa Rank Condition (With Clearbit)
Page targeting
Manage Your Frequency Settings
Contextual Targeting for Dummies
Form & Fields
Collect the URL on which the popup form is submitted
Collect the UTM parameters when a popup form is submitted
Adding more fields to your form
Select the dates available in your forms
Collect phone numbers
Personalization
Dashboard & Analytics
Google Analytics reports
Set up the Google Analytics integration
Use Google Analytics to break down your popups performance by traffic channel
Wisepops events in Google Analytics (Universal Analytics)
Wisepops events in Google Analytics (GA4)
Use Google Analytics to identify the pages where your popups perform best
Use Google Analytics to analyze Wisepops impact on your sales
Track clicks on your links using Google Analytics
A/B Testing
Goal tracking
Set up Goal Tracking for Wisepops
How to set up Goal Tracking in Shopify
How to Set Up Goal Tracking in Magento
How to set up goal tracking using Google Tag Manager
Disable Wisepops on my device
How to Filter Out Internal Traffic
Scheduling your campaigns
How to track clicks in HTML blocks
Time zone used for reporting
Download your emails or survey results
Understand the basic Wisepops metrics
How to track signups with a tracking pixel
How to duplicate and move a campaign
Exclude your device
Integrations
CMS Integrations
WordPress / WooCommerce
Shopify
How to Create an Average Cart Value Booster
Use the wisepops() function on Shopify
Apply a Shopify discount code to the cart
Add a product to the cart when a CTA is clicked (Shopify)
Display a campaign when a product is added to the cart (Shopify)
Add Wisepops with Google Tag Manager
Add Wisepops to Zoey
Add Wisepops to Webflow
Add Wisepops to Instapage
Add Wisepops to Blogger
Check your code implementation using Mozilla Firefox
Add Wisepops to Big Cartel
Add Wisepops to Drupal 8
Add Wisepops to BigCommerce
Check your code implementation using Google Chrome
Add Wisepops to Umbraco
Add Wisepops to Joomla
Add Wisepops to Squarespace
Add Wisepops to Magento 2
Add Wisepops to Google Sites
Add Wisepops to Cratejoy
Add Wisepops to 3dcart
Add Wisepops to Prestashop
Add Wisepops to Shopify
Add Wisepops to Weebly
How to add Wisepops to a custom website?
Add Wisepops to Wordpress/WooCommerce
Add Wisepops to Volusion
Add Wisepops to SiteBuilder
Add Wisepops to Drupal 7
Add Wisepops to Neto
Wisepops on Single-Page Applications
Add Wisepops to Mono
Add Wisepops to Opencart
Email Integrations
Klaviyo
Ometria
Splio
DotDigital
Emarsys
Mailchimp
Pipedrive
SendGrid
Hubspot
SendinBlue
Selligent
ActiveCampaign
Drip
Iterable
Customer.io
Other Integrations
Connect Wisepops with Mad Mimi
Connect Wisepops with Campaign Monitor
Connect Wisepops with Bronto
Connect Wisepops with Experian (Cheetah)
Connect Wisepops with Zaius
Connect Wisepops with Actito
Connect Wisepops with Acoustic
Connect Wisepops with Voyado
Connect Wisepops with Listrak
Connect Wisepops with Constant Contact
Connect Wisepops with GetResponse
Connect Wisepops with SmartrMail
Connect Wisepops with Keap (formerly Infusionsoft)
Connect with Mailjet
Connect Wisepops with Omnisend
SMS integrations
Connect Wisepops with Yotpo
Connect Wisepops with Emotive
Connect Wisepops with Blueprint
Connect Wisepops with Postscript
Zapier
Send your leads to a Google Spreadsheet (using Zapier)
How can I take advantage of the Zapier integration?
Connect Wisepops with ConvertKit (through Zapier)
Send a notification when an email is submitted (through Zapier)
Connect Wisepops with AWeber (through Zapier)
Connect with Close.io (through Zapier)
API
Other integrations
Managing Your Account
Security
Data and cookie policy
Data security policy
Limit the impact of Wisepops' cookies on your website
Vulnerability Reports & Bug Bounty Program
Using Wisepops with a Content Security Policy
Datenschutz- und Cookie-Richtlinie
Protect your campaigns against bots
Legal & Compliance
Add/Delete Website
Add, edit, and delete users
Upgrade or downgrade your subscription
How do I cancel my subscription?
Use Distinct Websites for Staging and Production
Use right-to-left writing
FAQ
How to fix email synchronization issues
My popup doesn't display
How to handle required merge fields
Tips for effectively reporting an issue
What are page views?
Preview your popup on a hidden URL
Will Wisepops slow down my website?
Everything you need to know about the migration to V3
Collected emails don't appear on my dashboard
Can I use Wisepops on multiple domains?
Uninstall Wisepops from your Shopify website
Why does my popup look broken?
My Popup is Locked!
Can I show more than one popup on the same page?
Why does my popup appear for a few seconds and disappear?
Tutorials
- All Categories
- Wisepops
- Campaign Builder
- Display Scenario Settings
- Triggers
- Set Custom Events to Trigger Popups
Set Custom Events to Trigger Popups
Updated
by Lisa Fockens
Before you read this article, please note the below points:
- Fired custom events count as page views in your monthly quota
- Events must be configured by someone with technical skills
Introduction
The display of a popup can be triggered by a custom event. Custom events allow you to link Wisepops with any kind of user activity on your website.
Here are a few examples of custom events you can set to trigger popups:
- Visitor clicks a specific button or link
- Visitor adds a new product to cartย
- Visitor views an out-of-stock item
- Visitor visits a product page whose price is above $X
- Visitor selects a specific option in a menu
Configuring a custom event as a display trigger
A custom event can be set as a display trigger for a popup in the Display menu. Select On custom event and then give your custom event a name.

Firing the custom event from your website
You can fire a custom event as soon as the Wisepops code has been executed.
wisepops("event", "my-custom-event");
- "event": a string that indicates that you want to fire a custom event. Leave it as it is.
- "my-custom-event": the name of your custom event.
Examples
Here are two commonly used examples of custom event triggering.
1. When a user clicks a link or a button
In this example, we will set up a custom event fired on a user click.
On the Wisepops Display menu, select On custom event and then enter a custom event name of your choice.

On your website, add a link and make it fire the custom event.
<a href="#" onclick="wisepops('event', 'user-click'); return false;">Click here</a>
The snippet return false;
tells the browser not to follow the link provided in href
.ย
You can also get the exact same result with a button:
<button onclick="wisepops('event', 'user-click');">Click</button>
Now, try clicking the link or the button. If the rest of the display scenario is matched (display options and target visitors), the popup will show.
2. After a progress bar completes
In this example, we will set up a custom event for the jQuery Progressbar completion.
On the Wisepops Display menu, select On custom event and then enter a custom event name of your choice.

We now want to fire the custom event progress-complete
once the jQuery UI progress bar widget reaches its maximum. Write something like this, right after the Wisepops setup code:
$(".selector").on("progressbarcomplete", function (evt, ui) {
ย ย wisepops("event", "progress-complete");
});
The popup will be immediately displayed if its display scenario is matched (display frequency, location targeting, etc.).
No need to use custom events for Single Page Applications (SPAs)
SPA are websites that do not reload the document when the page changes. Instead, the new content is injected into a container, and the URL is dynamically changed.
Once the page has changed, you can tell Wisepops to restart the scenario resolution by running the following JS line:
wisepops("pageview");ย
ย
Debugging and troubleshooting
If the wisepops()
function is not defined, please make sure that the Wisepops setup code is up-to-date.
It should start by (function(W,i,s,e,P,o,p)
.
You can view some Wisepops activity logs through the browser console.
Go to your website, where Wisepops is installed.
Open the developer tools by hitting F12, and click on the "Console" tab.
Inside the console, type wisepops("log")
and hit Enter.
Not seeing your popup on your website? Try these tips.