The popup editor, step by step
Every option in the Divi Smart Popup editor — Design, Layout & style, Triggers, Targeting, Frequency, Goals and Advanced — with its default.
Open a popup from Popups → All Popups and select Configure. The editor has seven steps on the left, each with a one-line summary, and a Summary panel on the right that flags anything that needs attention. The top bar holds the popup name, the Active toggle, Preview, Check campaign, Design in Divi and Save changes.
1. Design
Open Divi Builder opens the popup’s layout in the Divi 5 Visual Builder in a new tab. Save your settings first, so the canvas uses the latest size. Preview on site shows the popup on your site.
This step also lists the link values for buttons inside the popup: #d5pe-close closes the popup, #d5pe-open-{ID} opens it from a menu item, button or text link, and the CSS class d5pe-dismiss closes it and never shows it to that visitor again.
2. Layout & style
- Popup type — Modal (default), Slide-in, Top bar, Bottom bar, Fullscreen, Drawer (left), Drawer (right).
- Position (modal and slide-in) — default centre for a modal.
- Width — desktop 600px; Tablet empty (same as desktop); Phone 90vw. Not shown for bars and fullscreen.
- Max height 90vh — taller content scrolls inside the popup.
- Corner radius 0px, Popup background #ffffff (set it to transparent to let the Divi design define every edge), Drop shadow on, Offset X / Offset Y 0px.
- Overlay — Show overlay on, Overlay color rgba(0,0,0,0.6), Background blur (px) 0, Close when the overlay is clicked on.
- Close button — shown, Placement Inside, top right (or inside top left, corner top right, corner top left), Icon size 24px, Icon color #333333, Button background transparent, Show close button after (seconds) 0.
- Animation — Entrance and Exit Fade (also None, Zoom, Slide up/down/left/right), Duration 300ms. Visitors who prefer reduced motion always get an instant change.
- Behavior — Prevent page scrolling while open on (modal, fullscreen and drawer only), Close with the Escape key on, Close automatically after (seconds) 0 (stays open).
3. Triggers
Add one or more triggers; the popup opens as soon as any one of them happens. A new popup has On page load after 3 seconds. With no triggers it opens only from links. Each trigger is described in the Trigger reference.
4. Targeting
Show on (default: Entire site), Never show on, Visitors (Everyone, Logged-out visitors, Logged-in users, optional roles), Devices (all three by default) and Schedule (off). See Targeting rules and Schedules, priority and site-wide limits.
5. Frequency
How often should a visitor see it? Once per visit by default; also Every time, Every few days (7 by default) and Only once. Plus Maximum times in total (0 = no limit), stop after a conversion (on) and hide for a number of days after a close (0). See Frequency caps.
6. Goals
A form inside the popup is submitted (on), A click on these elements inside the popup (optional selector), After a conversion Close the popup / Go to a page / Keep it open, and Wait before that 2 seconds. See Embed a form in a popup.
7. Advanced
- Priority 1–10, default 5. When two modal-style popups want to open, the higher priority goes first and the other waits.
- Screen reader label — announced when the popup opens. Empty uses the popup’s first heading, or the popup name when it has no heading.
- Extra CSS classes — added to the popup wrapper.
- Elements that close the popup — a CSS selector for elements inside the popup, for example
.no-thanks. - Count views and conversions — on by default. Turn it off to leave this popup out of Analytics.
- JavaScript — the
D5PE.open()andD5PE.close()calls for this popup. See Hooks and filters.
Did this answer the question? No — open a support request