Skip to content

Black Friday 50% off your first year on all premium plugins and the Suite.

See the deals

Divi Smart Popup documentation

Design popups in the Divi 5 Visual Builder, then decide who sees them, when and how often. Install, licence, triggers, targeting and fixes.

1 min read · Updated 16 November 2026

Divi Smart Popup turns a Divi 5 layout into a popup. There is no popup module to learn: you design in the Divi Builder with the sections, rows and modules you already use, then set the rest from a guided editor with seven steps.

You can also describe a popup in plain language. With an active licence, ByteKeel AI builds the design from editable Divi 5 modules and sets its type and trigger; built-in rules add the pages, visitors and frequency they recognise in your request, for you to review. Open an existing popup to ask AI for changes, review them, then apply or keep editing in Divi.

These pages are written against Divi Smart Popup 2.1.x; the current release and what changed in it are on the changelog. If something behaves differently from what is described here, that is a bug in one of the two and we want to know which.

If you are starting now

  1. Install Divi Smart Popup — requirements and installation.
  2. Activate your Divi Smart Popup licence — for updates and downloads.
  3. Publish your first popup — template, trigger, targeting, test.
  4. Create a popup with ByteKeel AI — describe it, then review the draft.

When something is not working

Start with Divi popup not working?, which covers desktop and mobile. The built-in Check campaign panel explains every rule for the page you are on. The frequently asked questions cover the rest.

Getting started

  • Install Divi Smart PopupDivi Smart Popup requirements (WordPress 6.6+, PHP 7.4+, Divi 5 theme) and how to install it from the zip or with WP-CLI.
  • Activate your Divi Smart Popup licenceFind your Divi Smart Popup licence key, activate it from the popup manager, and see what is sent and what the licence does and does not control.
  • Publish your first popupBuild a popup in the Divi 5 Builder from a template, give it a trigger, limit it to one page, switch it on and test it safely.

Building popups

  • Create a popup with ByteKeel AIDescribe a Divi popup in plain language and ByteKeel AI drafts it from Divi 5 modules with a type and trigger. What it needs, sets and leaves to you.
  • Choose a popup typeThe seven Divi Smart Popup types — modal, slide-in, bars, fullscreen and drawers — what each one costs the visitor, and the defaults each applies.
  • Embed a form in a popupPut a Divi Contact Form, Email Optin or form plugin inside a popup, count submissions as conversions and close the popup afterwards.
  • The popup editor, step by stepEvery option in the Divi Smart Popup editor — Design, Layout & style, Triggers, Targeting, Frequency, Goals and Advanced — with its default.

Triggers and targeting

  • Trigger referenceEvery Divi Smart Popup trigger — page load, scroll, exit intent, click, inactivity, page views, URL parameter — what it measures and when it does not fire.
  • Frequency capsHow often one visitor can see the same Divi popup — every time, once per visit, every few days or once — and where that is remembered.
  • Targeting rules: pages, visitors and devicesShow a Divi popup on chosen pages, post types, archives, categories or authors, exclude pages, and limit it by login state, role and device.

Scheduling and limits

Licensing and accounts

  • What each licence state meansEvery state on the Divi Smart Popup licence screen, from Active and Cancelled to Expired and Revoked, and what each means for updates.
  • Move a Divi Smart Popup licence to another siteFree a Divi Smart Popup licence slot with Deactivate this site, or remove the old site in your ByteKeel account, then activate the new site.
  • Licence screen messagesWhat each message on the Divi Smart Popup licence screen means (key already used, not found, server unreachable) and how to fix it.

Troubleshooting

  • Divi popup not showing?Why a Divi popup does not open on desktop or mobile, or stopped after an update: checks for native Divi 5 popups and Divi Smart Popup, fastest first.
  • Caching referenceWhich Divi Smart Popup rules run in the browser, which run while the page is built, and how to set up page caching and script optimisation.
  • Frequently asked questionsAnswers to common Divi Smart Popup questions: Divi 4, caching, opening from a menu, video, licences, uninstalling and privacy.

Settings and tools

  • Popups › SettingsEvery option on the Divi Smart Popup Settings screen: the site-wide switch, automatic popup limits, statistics and the uninstall option, with defaults.
  • Analytics and CSV exportRead Divi Smart Popup views, closes and conversions by popup, date range and device, and export them as CSV. What is counted and what is not.
  • Export and import popupsMove Divi popups between sites as a JSON campaign file with their Divi design, presets and settings. How mapping works and what is not included.

Developers

  • Hooks and filtersDivi Smart Popup’s JavaScript API (D5PE.open, close, convert), its d5pe:open, d5pe:close and d5pe:convert events, and markup classes.

Guides

Did this answer the question? No — open a support request