How to set frequency and cookie rules
The Display Frequency setting controls how often the same visitor sees a popup. This guide explains each option and how the underlying browser storage works.
Display Frequency options
In the Display section of the popup editor, set Display Frequency to one of four values.
Always
The popup opens every time the visitor loads a page where the popup is active. No browser storage is written.
Use this for content that must always be visible — for example, a legal notice or an urgent service disruption message.
Once per Session
The popup opens at most once per browser session. After the popup opens, the plugin writes a session cookie named ssd_popup_<popup-id> (no expiry date, path=/, sameSite=lax, and secure over HTTPS). A session cookie is shared across all tabs and windows of the same browser and is cleared automatically when the browser is closed.
This means the popup shows once per browsing session no matter how many tabs or windows the visitor opens — including opening a subpage in a new tab — and shows again on the next visit after the browser has been closed.
Why a cookie and not
sessionStorage?sessionStorageis scoped to a single tab. Opening a link in a new tab gave that tab a fresh, empty store, so a "Once per Session" popup wrongly re-appeared. A session cookie is shared across the whole browser session, which matches what "once per session" is expected to mean.
Use this for welcome messages or discount reveals where you want the popup on the first visit of each browsing session but not on every page navigation.
Once per Day (24 h)
The popup opens at most once every 24 hours. The plugin writes a { timestamp } object to localStorage under the key ssd_popup_<popup-id> and checks whether more than 24 hours have elapsed since that timestamp.
Use this for daily promotions or news announcements.
Once Ever
The popup opens exactly once per browser profile. The plugin writes to localStorage under the same key and never shows the popup again as long as that key exists.
Use this for true first-time-only messages — for example, a "Welcome to our shop" offer for brand-new visitors.
How browser storage is used
The plugin uses a session cookie for Once per Session and localStorage for Once per Day and Once Ever. All keys follow the pattern ssd_popup_<popup-id>.
- Once per Session — a session cookie (no expiry) shared across all tabs and windows, cleared when the browser closes.
- Once per Day / Once Ever — a
{ timestamp }object inlocalStorage, which persists across sessions until the timestamp expires (24 h) or the key is removed (Once Ever).
Because the plugin uses browser storage rather than server-side sessions or account flags:
- The frequency cap applies per browser profile, not per account. A visitor who uses a different browser or a private tab will see the popup again.
- Clearing browser data (history, cookies, localStorage) resets all frequency caps for that browser.
The plugin also registers an entry in the Shopware Cookie Manager under the Required cookie group (cookie name: ssd_ultimate_popup). This registration declares to the cookie manager that the plugin stores a strictly-necessary frequency flag in the browser — so no consent gate is required before a popup can apply its frequency cap.
Examples
| Goal | Display Frequency |
|---|---|
| Always show a legal notice | Always |
| Welcome message once per visit | Once per Session |
| Show a deal once a day | Once per Day (24 h) |
| First-visit-only onboarding popup | Once Ever |