How to create a popup
This guide covers every field available when you create or edit a popup in Content > Ultimate Popups. The Getting started tutorial explains the happy path; this guide is the exhaustive field-by-field reference for the editor form.
The editor is organised into three cards: General (global settings), Display (per-device settings on Desktop / Tablet / Mobile tabs), and Conditions (global targeting).
Open the popup editor
- To create a new popup: navigate to Content > Ultimate Popups and click Add Popup.
- To edit an existing popup: click any row in the list to open its detail view.
General section
These settings are global — they apply to the popup regardless of device.
Active
Toggles the popup on or off. Inactive popups are never shown in the storefront.
Name (required)
An internal label shown in the popup list. Shoppers never see this. Use something descriptive, for example Summer Sale 2026 — Exit Intent.
Display Frequency
How often the popup is shown to the same browser: Always, Once per Session, Once per Day (24 h), or Once Ever. This is a per-visitor cap and is not a per-device setting. See Set frequency and cookie rules.
Display section (per device)
The Display card has three tabs — Desktop, Tablet, and Mobile. Every field here can vary per device: Desktop is the base, and Tablet and Mobile inherit Desktop until you click a field's chain-link icon to unlock it. See Configure appearance for how inheritance works in detail.
Each tab groups the same four subgroups.
Content
| Field | Description |
|---|---|
| CMS Page | The Shopping Experience page rendered inside the modal. Required on the Desktop tab; optional on Tablet/Mobile (inherits Desktop when left inherited). Create the page in Content > Shopping Experiences first. The plugin applies zero padding to the modal body, so the CMS page controls all spacing. |
Appearance
See Configure appearance for details.
| Field | Description |
|---|---|
| Modal Size | Small, Default, Large, Extra Large, or Fullscreen. |
| Vertical Alignment | Where the popup sits vertically: Top (default), Center, or Bottom. |
| Hide Header | Hides the modal header bar and repositions the close button as a floating overlay over the content. |
| Light close icon | Shows the × button in white so it stays visible on dark popup backgrounds. Off (default) keeps the normal dark ×. Per-device, so you can turn it on for Mobile only. |
Trigger & Timing
See Set triggers and timing for details.
| Field | Description |
|---|---|
| Display Trigger | Immediate (on page load) or Exit Intent. |
| Delay (seconds) | For Immediate, the wait after page load before opening. For Exit Intent, the touch-device fallback wait (default 30 s). |
| Required cookie consent | The popup stays hidden until the visitor accepts the selected cookies in the storefront cookie-consent banner. Use this when the popup loads consent-requiring content such as a third-party newsletter form. Leave empty to show regardless of consent. |
Custom CSS
Per-device CSS to fine-tune this popup. It is automatically scoped to this popup and device — write selectors relative to the modal (e.g. .btn-close). See Custom CSS.
Close the popup from a link or button
To let a link or button inside your CMS content close the popup, add the CSS class ssd-popup-close to it. The plugin listens for clicks on any element carrying that class (including child elements) and closes the modal.
<a href="https://example.com/" target="_blank" class="ssd-popup-close">Visit and close</a>
<button type="button" class="ssd-popup-close">No thanks</button>Use the class — not data-bs-dismiss="modal". Shopware's HTML sanitizer strips data-* attributes from CMS content, so data-bs-dismiss never reaches the storefront. The class attribute survives sanitization.
Conditions section
These settings are global. See Target specific pages for a detailed guide.
| Field | Description |
|---|---|
| Sales Channels | Which sales channels this popup appears on. Leave empty for all. |
| Trigger Rules | Shopware Rule Builder rules. All selected rules must match (AND). Leave empty to show to all visitors. |
| Targeting Mode | Page Restriction (named Shopware routes) or Custom URL (wildcard patterns). Leave empty to target all pages. |
| Page Restriction | Shown when Targeting Mode is Page Restriction. Select from: Home Page, Cart Page, Checkout Confirm, Checkout Finish, Login Page, Product Detail, Category/Listing. |
| Category Restriction | Shown when Page Restriction includes Category/Listing. Limits the popup to specific categories. |
| Product Restriction | Shown when Page Restriction includes Product Detail. Limits the popup to specific products or variants. |
| Custom URLs | Shown when Targeting Mode is Custom URL. Relative paths or wildcard patterns such as /landing/*. |
Save
Click Save in the smart bar. A success notification confirms the popup has been saved. Changes take effect on the next page load in the storefront (the plugin invalidates cache tags for all pages where the popup was active).
Delete a popup
Select the popup in the list (checkbox), then choose Delete from the bulk-action dropdown. Deletion cascades and removes all associated rule, category, and sales-channel mappings.