PopupAlly Tutorials - PopupAlly Not Working? We've Got You Covered!

On these pages you'll find our in-depth tutorials for the free version of PopupAlly. PopupAlly not working? Take a look at our troubleshooting guide, chances are it's something we've covered here before!

1. Installation

PopupAlly can be installed through two methods:

  • Built-in plugin directory
  • Downloaded Zip file

1.a Install through plugin directory

Go menu Plugins -> Add New.

1a - plugin add new

Search for ‘PopupAlly', then click on ‘Install Now'.

PopupAlly Tutorial

Once the installation is complete, click on ‘Activate' (or ‘Network Activate' if you are using a Multisite).

PopupAlly Tutorial - Activate Plugin

1a - activate

1.b Install through Zip File

Download the latest PopupAlly version from the WordPress directory.


Once the file has been downloaded, go to menu Plugins -> Add New. In the ‘Upload' tab, select the zip file that was downloaded, then click on ‘Install Now'.

1b - plugin install

Once the installation is complete, click on ‘Activate' (or ‘Network Activate' if you are using a Multisite).

1b - activate

Congratulations! You have now successfully installed PopupAlly! You should now see the PopupAlly menu item in the left hand sidebar.

Screen Shot 2016-08-19 at 10.25.24 AM

2. Configure Popup Style

Now we want to customize the look-and-feel of the popups.

Go to PopupAlly in the left menu.

PopupAlly - Popup Setup

PopupAlly gives you 2 popups to work with. (If you want more, try PopupAlly Pro!) You don't need to use both of them, but here are a couple ideas for 2 popups:

  • Use the first popup as the newsletter signup and the second for special announcement
  • Use the first popup as a time-delayed popup and the second as an exit-intent popup with extra attention grabbing headline, like ‘Wait!', ‘Don't go!!', etc

Before we get into configuring the specifics, it is highly recommended to give the popup a meaningful name:

PopupAlly Tutorial - Name

The next part of the setup is split into two main sections:

  • Integration: how the popup will interact with your email service provider
  • Customization: the look and feel of the popup

2.a Integrating PopupAlly With Your Email Service Provider (ie Mailchimp, Aweber, MadMimi, GetResponse, ConvertKit, Ontraport, Active Campaign, Constant Contact, Simplero, MailerLite, Klaviyo)

PopupAlly helps you create popups and opt-in forms designed to collect subscriber information. In order to do this, it must be integrated with an email service provider (MailChimp, AWeber, etc.). On its own, PopupAlly cannot collect email addresses or send emails.

To establish the integration, PopupAlly only needs the HTML code that's provided by your email marketing software, and it will handle the rest.

If you don't have an email service provider yet, we highly recommend Aweber as a first choice.

We've put together a quick guide on how to get the HTML code for a few of the more common email marketing platforms:

Once you have the sign-up form HTML, just paste it into ‘Sign Up HTML', under the Style Settings inside PopupAlly.

PopupAlly Tutorial - Sign Up HTML

Once you click out of the text box, two additional fields will appear, allowing you to select the input fields for name and email.

PopupAlly Tutorial - FNAME
(If the HTML code is incorrect, you will get an error message. Hopefully it won't come to that.)

2.b Customization

PopupAlly Tutorial - DesignThe customization section provides a wide range of options to change the look-and-field of the popup. Any change will show up immediately in the Preview box, which is exactly what the popup will look like when shown. (Want more customization options? Try PopupAlly Pro!)

Currently two templates are available for customization with the free version of PopupAlly:

  • Tried-and-True: This is the default template and it is perfect if you want to set up a popup quickly.
  • Express Yourself: This is template provides you the freedom to change the size of the window. You can also add your own background image. The default size is perfect for embedded sign up forms.

Once you've decided which design you'd like to start with, simply scroll down in the Style Settings to further customize your popup with images, logos, fonts, and colors.

PopupAlly Tutorial - Pro Tip

3. Configure Popup Display

The display settings control how the popup will appear to visitors to your site. To configure the display settings, go to menu PopupAlly > Display Settings.

3.a When will the popups be displayed?

PopupAlly can show your popup under two conditions: (Want more options? Try PopupAlly Pro!)

PopupAlly Tutorial - Display Settings

Trigger: Description:
Time-delayed Display popup after a set delay (in seconds). This is the most common popup. Generally, the delay should be set to at least 30 seconds, or it runs the risk of being annoying to visitors. (See sample page here)
Exit-intent This is the latest innovation in attention capturing. It is triggered when the mouse cursor heads up towards the close button. (See sample page here)
Embedded This is technically not a popup. However, as it is useful to embed a signup form directly on the page. It is recommended to use the ‘Express Yourself' template for an embedded sign up form. (See sample page here)

3.b Show the popups on which pages

After at least one of popup options has been selected, you can configure on which post(s)/page(s) the popup will be displayed.

PopupAlly Tutorial - Posts Pages

You can choose to use two selection methods:

  • Inclusive – show the popup for posts/pages that have been explicitly entered: leave the ‘Show for all pages?' option unchecked, checkbox the pages/posts you want to display the popup in ‘Use for only these posts/pages'. Alternatively, you can checkbox ‘All pages' and/or ‘All posts', which will show the popup for all existing and future pages/posts, respectively.
  • Exclusive – show the popup for all posts/pages that have NOT been excluded: check the ‘Show for all pages?' option, checkbox the pages/posts you want NOT to display the popup in ‘Except for these posts/pages'. Alternatively, you can checkbox ‘All pages' and/or ‘All posts', which will prevent the popup from displayed in all existing and future pages/posts, respectively.

3.c How to stop the popups from annoying the visitors

Occasional popups are effective at increasing conversion, but showing them too often can be annoying to visitors.

There are two ways to stop a popup from appearing:

  1. Show popup every [x] days: this setting controls how frequent the same visitor will see the popup. Only use -1 for testing purpose, as it will show the popup every time the page is loaded.

    PopupAlly Tutorial - How Often

  2. Thank you page: See detailed tutorial on how to Setup the Thank You page

4. PopupAlly Not Working? Here Are Some Testing Tips

Congratulations! You have now set up the popup(s). Here are a couple tips for testing:

4.a Is it on a page?

To confirm whether a popup is configured for a specific post/page, PopupAlly has a handy widget that provides that information.

Just open any post/page in edit mode, and you will see the ‘PopupAlly Display Setting' widget on the top right, showing the display type for each popup (if any).

PopupAlly Tutorial - Widget

4.b Why is it not popping up?

As mentioned in section 3.c, the popup will only appear ever [x] number of days. This is great for visitors, but bad when you are configuring the popup. There are 3 ways to skip the wait:

  1. Set ‘Show popup every' to -1: just refresh the page and the popup will be configure to appear. This is the simplest testing method, but also most dangerous: make sure to change it before showing it to visitors! If you decide to test with this method, make sure ‘Use for only these posts/pages' is NOT checked, and create a testing page specifically for this purpose and put the page id in ‘Use for only these posts/pages'.
  2. Make use of the private browsing mode built into most browsers. Close and re-opening the private browsing window is like starting with a clean slate.
    PopupAlly Not Working
    4 chrome incognito
  3. Clear cookies: this method is a bit extreme, as you will likely need to log into WordPress again. Use the private browsing method whenever possible

Have fun creating popups! Make sure to leave us a review at PopupAlly.


AmbitionAlly WordPress Plugins