Usage

Creating Popups

Navigate to Leads in the control panel sidebar to create and manage popups. Each popup is a Craft element with full element index support — including drafts, statuses, and search.

Auto-Inject Mode

By default, Leads automatically injects active popups on all frontend pages. No template changes are required — publish a popup and it appears wherever its targeting rules match.

Manual Control

For more control, disable auto-inject and render popups yourself with Twig:

{# Render all active popups #}
{{ leadsPopups() }}

{# Render a specific inline form #}
{{ leadsInline("newsletter-signup") }}

{# Query popups programmatically #}
{% set popups = craft.leads.popups.popupType("modal").all() %}

Triggers & Targeting

Each popup can be shown on a time delay, scroll percentage, exit intent, or click. Its Targeting Rules, set in the popup editor, decide who sees it:

• Show on / Don’t show on — URL patterns, one per line (/blog/*). Exclusions win.
• Devices — desktop, tablet and mobile.
• How often — on every page view, once per session, once per visitor, or at most every N days.
• Visitors — everyone, new visitors only, or returning visitors only.
• After page views — wait until the visitor’s Nth page view on the site.
• Days hidden after closing and Hide after signing up — so nobody is asked twice.

Page rules are applied on the server. Device, frequency and visitor rules are decided in the visitor’s browser, with what they’ve seen kept in localStorage and a session cookie — so they work behind Blitz, a CDN or any other full-page cache. See Configuration for global defaults.