View Categories

Popup Maker Debug Mode

Popup Maker has its own debug mode to help you troubleshoot problems with your popups. This guide shows you 2 ways to turn on debug mode and goes over the debug info you’ll get.

This guide assumes you have some experience using a browser’s DevTools console.

You can switch on debug mode in the following 2 ways:

  1. Clicking the checkbox for the Enable Debug Mode setting under Popup Maker > Settings > Misc.
  2. Adding a debug query string to the end of a page’s URL.

Using the Enable Debug Mode Setting #

Follow these steps to turn on the debug mode via the Popup Maker plugin settings.

1. From your WP Admin area, go to Popup Maker > Settings.

File Igm7Tal4Cd

2. Click  Misc.

File Bu06Cijcpa

3. Click Enable Debug Mode. Make sure the checkbox is checked.

File Pbea8Yiyn4

4. Click  Save.

File Sbsaf2Zu8B

5. Hover over your website’s name in the top toolbar and click Visit Site.

File I4Qahzvlpm

6. After your homepage loads, open your browser’s DevTools console. In the console, while debug mode is on, you’ll see the Popup Maker banner. If the page has popups, you’ll see them listed under the Popups Initializing banner heading by their popup ID and slug (the hyphenated version of your popup’s name, e.g., my-cool-popup).

File Bgk4Kbcu5D

Missing a popup? #

If there’s a popup missing from the list, it means that the popup was *not* loaded on the page. You might’ve forgotten to publish the popup or there’s a targeting condition that’s stopping it from loading on the page.

If you’re having trouble getting your popup to load or display on a post or page, head over to our Troubleshooting Your First Popup guide.

Jump down to learn more about the info you get in the console while in debug mode.

Using the Debug Query Parameter #

You can also turn on the debug mode on a page using the pum_debug query parameter. Add ?pum_debug=true to the end of the page’s URL in the address bar and hit return.

Here’s an example of a URL with the debug query parameter on the end. Replace the mywaycool.site/blog with your URL.

https://mywaycool.site/blog/?pum_debug=true

Here’s a clip showing how the query parameter works.

File 0Faaj36Uoz

Debug Mode Console Details #

When you expand a popup entry under the Popups Initializing heading, you’ll see the triggers and device settings you defined for the popup. Expanding a trigger shows you the settings you have for the trigger.

For example, in the screen capture below, popup #534 (hello-world-popup) has an Auto Open and Click Open trigger. The Auto Open trigger has no cookies and will launch automatically after 0.5 seconds (i.e. 500 milliseconds). The Click Open trigger has no cookie, but it has 3 CSS selectors. This popup can display on all devices.

File Jqsjwm7Esb

When a popup launches, a banner heading for it shows up in the console. Under the heading is a list of Popup Maker JavaScript API events the popup fired as it launched. The event at the top of the list is the first event that fired. The event at the bottom is the last event.

File 8Qr6Whldyp

Leave the first comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.