Skip to content

How to design popups with live preview and deploy them at exactly the right time

A popup is built in two places. You create it and decide where and when it shows in Optins → Popups, then design what it looks like in the WordPress Customizer. Once it exists, any button or link on your site can open it.

This article covers the settings and steps. For what makes a popup worth opening (timing, copy, and layout choices), read how to design a website popup.

Before you start

Create a popup

  1. Go to Optins → Popups.
  2. Select Add New next to Popups Manager.
  3. Enter a name for the popup in the new entry’s title field. The name identifies the popup in the Customizer and in the popup menus across the admin.
  4. Select Save.

A new popup shows only the message “To edit this popup, first save the Popup Settings and return to this panel.”

After you save, open the popup’s entry again to see its Edit in Customizer and Copy Shortcode buttons and its display settings.

The Popups Manager on the Optins → Popups screen with one saved popup open, showing the Edit in Customizer and Copy Shortcode buttons above the Show on... checkboxes

Each saved popup has its own Edit in Customizer and Copy Shortcode buttons.

Design the popup in the Customizer

  1. In the popup’s entry, select Edit in Customizer. The Customizer opens in a new tab with the popup’s section open inside the Popups Designer panel, and the preview shows the popup by itself.
  2. Use the row of group buttons at the top of the section to move between settings. The preview updates as you change them.
  3. Select Publish to save the design.
GroupWhat it sets
ContentLede, Main Title, Subtitle, Description, and Footer Text
ImageThe Image, its Position, and its Width
ButtonEnable Main Button, its Text, Icon, Action, Size, and style
Button 2The same settings for Enable Secondary Button
EmailEnable Email Form, the Email List, an optional name field, and the field and button labels. The Submit Button Label is “Join Now!” until you change it.
LayoutTemplate (Standard or Holy Grail), Animation, and Padding
ColorsBackground, border, headline, text, close, and button colors, plus the Background Overlay behind the popup
DesignBorder Width, Box Shadow, Border Radius, and a Background Image
TemplateEnable custom template for your own Template HTML and Template CSS

Animation controls how the popup appears: Fade (default), Slide Up, Slide Down, or Zoom In.

Only popups are designed in the Customizer. Call to Action boxes and Floating Bars are designed on their own Optins screens.

The Popups Designer panel in the Customizer with a popup's section open on the Layout group, showing the Template and Animation menus beside the live preview

Switch between groups with the buttons at the top of the popup’s section.

Choose when it shows

Back in Optins → Popups, open the popup’s entry and set Show Method:

Show MethodWhen the popup opens
Show after X seconds (default)After the number of seconds in Show Delay. The default is 5.
Show on exit intentWhen the visitor moves the mouse to the top edge of the browser window
Show after scroll percentageOnce the visitor scrolls the percentage of the page in Show Delay

Exit intent watches for mouse movement, so it works on desktop. On phones and tablets, a popup set to exit intent does not open on its own.

Hide for… sets how many days the popup stays hidden after a visitor closes it. The default is 7 days. Enter 0 to show it on every visit.

Show to… limits the popup to All visitors, Logged in users only, or Logged out users only.

Choose where it shows

In the same entry, check the locations under Show on…: Sitewide, Front Page, Blog Page, All Posts, All Categories, All Pages, All Author Pages, Search Results, and any custom post types and taxonomies on your site. Then select Save.

A popup with no locations checked never opens on its own. It still opens from a button or link, which is useful for a popup that should only appear when a visitor asks for it.

Popups opened this way ignore Show Method and Hide for…: they open every time the visitor selects the trigger.

With a shortcode. Select Copy Shortcode in the popup’s entry and copy the shortcode from the box that appears. Paste it into any post or page:

[md_popup id="…" type="button" text="Open popup"]

Change text to your button’s wording. Set type to button, link, image (add image="…" with the image URL), or hidden, which loads the popup on the page with no visible trigger.

From a link field. Marketers Delight link fields, such as header links and Call to Action links, have a Type menu. Choose Open Popup, then pick the popup from the Open popup menu.

From another popup’s button. In the Customizer, open the Button or Button 2 group, set Action to Open popup, and choose the popup to open.

To put an email form on the page itself instead of in a popup, see Add an email form.

Add or remove a popup on one page

Edit the post, page, or term and open the Popups tab in the Optins box.

  • To add a popup to this page only: select Add New next to Add Popups, choose the popup in Show Popup, and set Show Method, Show Delay, and Cookie Duration (days hidden after closing, 7 by default). Save the post. The popup shows on this page with these settings, in place of its sitewide ones.
  • To remove a popup that the Popups Manager places here: check it under Remove from page and save. This list appears only when a popup targets this content.
The Popups tab in a post's Optins box, showing the Remove from page checkbox list and an Add Popups entry with Show Popup, Show Method, Show Delay, and Cookie Duration

Add a popup to one page or remove a sitewide one from it.

Check the result

Open a page the popup targets in a private browser window, so no earlier visit has hidden it, and wait for the show method you chose. The popup should open with the design from the Customizer.

A popup open on the front end of a Marketers Delight site

The finished popup on the front end.

If it doesn’t appear:

  • You may have closed it before. Clear your cookies or use a new private window, or set Hide for… to 0 while testing.
  • Check that a location under Show on… matches the page, and that Show to… includes you. Logged-in administrators count as logged-in users.
  • Exit intent doesn’t fire on phones and tablets.
  • If a shortcode shows nothing, confirm its id matches the popup’s ID from Copy Shortcode.

If you use a caching plugin, clear its cache and reload.

Alex Mangini

Hi, I'm Alex! I started writing about web design and blogging at 13 years old, which turned into client work, which led to building my own software. 15 years later I'm still at it, and Marketers Delight is the epitome of my philosophy for building on the web.