Appearance
Promo Popup
A timed popup for discounts, announcements, or email capture. It appears after a short delay and can be dismissed by the visitor.
What it looks like
Here's the Promo Popup section alongside its settings in the theme editor. The left panel shows the settings you'll see in Customize, and the right shows the result on your storefront.
Storefront preview

Image sizes
The image is requested at 600px wide and keeps its own shape — it is not cropped, so a tall image makes a tall dialog. Something close to a 3:2 or 4:3 landscape keeps the dialog comfortable on a phone.
Settings
| Setting | What it does |
|---|---|
| Color scheme | Picks which set of colors to use for the popup |
| Show after delay | How many seconds to wait before showing the popup |
| Display frequency | Once a visitor dismisses the popup, it stays hidden for the rest of their browsing session |
| Heading | The main text at the top of the popup |
| Text | A supporting message underneath the heading |
| Show newsletter signup | Adds an email input field so visitors can subscribe |
| Button label | What the button says |
| Button link | Where the button takes people when clicked |
| Image | An optional image across the top of the popup, above the text |
| Show on exit intent | Triggers the popup when the visitor moves their mouse toward the browser close button |
Blocks
This section does not use blocks.
When it isn't showing
It is a dialog: it renders nothing in the page and opens over it, after the Show after delay you set, or on exit intent if that is switched on — not immediately on load.
If it appeared once and will not return, that is Display frequency doing its job: Once per session remembers the dismissal for the browsing session and Once per week for seven days. Set it to Every visit while you are editing, or open the store in a private window.
Tips
- Set the delay to at least 5 seconds. Popups that appear instantly frustrate visitors who haven't had a chance to see your store yet.