OptinMonster Documentation

Documentation, Reference Materials, and Tutorials for OptinMonster



Debugging OptinMonster

Debugging OptinMonster

We have answered thousands of tickets, and these are the most common bug scenarios we have found and fixed. Please review the following items below before submitting a support ticket as the solution to your issue may already exist!

Quick Tip: Use Cmd + F (or Ctrl + F on a PC) to do a quick search for a term that may help you locate your bug and a possible fix.

Before You Start

When debugging OptinMonster, we would highly recommend using Google Chrome. They have a very helpful debugging tool that lets you know exactly where errors are occurring and the nature of them. When in Google Chrome, you can do the following:

  1. Visit the webpage where the error is occurring.
  2. Right-click on the page and select the “Inspect Element” option from the screen popup.
  3. Once the debugging window has appeared, click on the “Console” tab to the right.

If there are any JavaScript errors on the page, they will be listed in this console area. The message output can be very beneficial for debugging OptinMonster.

Find a bug? Learn how to submit a bug report!

Having an issue with WordPress? Please be sure to check for a plugin or theme conflict.

Campaign Not Showing

The following are the most common reasons a campaign fails to load as expected:

The most common reasons the campaign is not showing on your site:

  1. No Embed Code – be sure you’ve embedded OptinMonster on your site where it should appear. In WordPress it is necessary to also publish within the plugin even if you’ve already published within the app. Be sure to publish the campaign as this screencast demonstrates.
  2. Caching – be sure to clear the cache after making any publishing changes. Similarly, if you are minifying, combining, or deferring Javascript through your caching or pagespeed plugin this can cause issues with OptinMonster. We recommend excluding our script from all modifications.
  3. Cookies – we use cookies to control how often a campaign can reappear to the same visitor. Try using a brand new Incognito window.
  4. Browser Extensions – sometimes extensions can interfere with OptinMonster. Try testing using a brand new Incognito window.
  5. Browser – some niche privacy browsers can prevent OptinMonster from loading. We support all major browsers (Chrome, Edge, Firefox, Safari, Opera). Try testing using a major browser.
  6. AdBlock – an ad block tool you’re using has filters targeting OptinMonster scripts. The best solution here is to use our Custom Domains feature to serve OptinMonster resources from your own domain.
  7. Page Targeting – it’s possible that the Display Rules configured in the campaign builder and the Output Settings configured in the plugin are conflicting with one another. Reach out to support for direct assistance.
  8. Javascript Error – on your site any javascript errors could negatively affect OptinMonster functionality. Try resolving all existing errors on the site to see if that resolves the issue. If it persists, reach out to support for assistance.

WordPress Debugging

Helpful Documentation:

Non-specific issue, just not working in general

Be sure to check for a possible plugin or theme conflict before reaching out to support.

I have downloaded the OptinMonster WordPress plugin .zip file but it’s appearing as a folder in my Downloads. What do I do?

All you need to do is re-zip the folder so that you can then follow the installation instructions for installing OptinMonster. Your browser is probably set to unzip a file upon download. You can re-compress the OptinMonster file yourself (so it is zipped) and upload it to WordPress, install OptinMonster from your Plugins > Add New screen, or you can manually upload it using FTP.

If you’re serious about jumpstarting your eCommerce business growth, then get started with OptinMonster today!

Get Started With OptinMonster Today!

BONUS: Done-For-You Campaign Setup ($297 value)
Our conversion experts will design 1 free campaign for you to get maximum results – absolutely FREE! Click here to get started →

Still stuck?

How can we help?

Last updated on

Start Getting More Leads & Sales Today with OptinMonster!

Start Getting More
Leads & Sales Today
with OptinMonster!

Create and launch smart capture forms today in minutes. What are you waiting for?

Create and launch smart capture forms
today in minutes. What are you waiting for?

OptinMonster has transformed our business. Before integrating their optins, our clients saw a 2% conversion rate from web traffic, which is slightly above the standard for their industry. With the integration of OptinMonster’s lightbox popup, exit-intent technology, split testing, and other tools, our client’s conversion rates soared by an unprecedented 500%. They attracted substantially more customers while spending less on digital advertising. Their success propelled them to the top of their markets, outperforming national chains and other medical spas with much bigger marketing budgets. Our client’s success in their market has distinguished us in our own. We are now one of the most sought-after marketing firms in the industry of aesthetic medicine. We know that the integration of OptinMonster, more than any other tool or marketing strategy, has supported this growth and achievement.

chris zelig medstar media

Chris Zelig

Partner, Medstar Media

OptinMonster has been a game-changer for us. From driving donations to collecting new leads, there is nothing that this simple tool has failed to accomplish. Our lead collection rate has jumped by over 1,000%.

joe lowe american bird conservancy

Joe Lowe

Director of Digital Communications, American Bird Conservancy

Through OptinMonster’s exit-intent popups, we have more than doubled our sales conversion rate. Best of all is the compound effect of using OptinMonster over a long period of time—more conversions mean more customers, which means more word of mouth.

mitch smith, managing director, shockbyte

Mitch Smith

Managing Director, Shockbyte.com