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
- You need an Administrator account on a site running Marketers Delight 6.0 or later.
- Install and activate the Optins Drop-in.
- To collect email addresses in a popup, connect an email service first. The Optins guide shows how.
Create a popup
- Go to Optins → Popups.
- Select Add New next to Popups Manager.
- 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.
- 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.
Design the popup in the Customizer
- 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.
- Use the row of group buttons at the top of the section to move between settings. The preview updates as you change them.
- Select Publish to save the design.
| Group | What it sets |
|---|---|
| Content | Lede, Main Title, Subtitle, Description, and Footer Text |
| Image | The Image, its Position, and its Width |
| Button | Enable Main Button, its Text, Icon, Action, Size, and style |
| Button 2 | The same settings for Enable Secondary Button |
| Enable 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. | |
| Layout | Template (Standard or Holy Grail), Animation, and Padding |
| Colors | Background, border, headline, text, close, and button colors, plus the Background Overlay behind the popup |
| Design | Border Width, Box Shadow, Border Radius, and a Background Image |
| Template | Enable 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.
Choose when it shows
Back in Optins → Popups, open the popup’s entry and set Show Method:
| Show Method | When the popup opens |
|---|---|
| Show after X seconds (default) | After the number of seconds in Show Delay. The default is 5. |
| Show on exit intent | When the visitor moves the mouse to the top edge of the browser window |
| Show after scroll percentage | Once 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.
Open a popup from a button or link
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.
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.
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
idmatches the popup’s ID from Copy Shortcode.
If you use a caching plugin, clear its cache and reload.



