The contest popup is a theme block that displays your contest in a modal overlay on your storefront. It's a great way to capture entries from visitors who are already browsing your store.
Adding the Popup to Your Theme
- In your Shopify admin, go to Online Store > Themes.
- Click Customize on your active theme.
- In the theme editor, look for the App embeds section (usually in the left sidebar under the paintbrush icon).
- Find Contest Popup and toggle it on.
- Select which contest to display using the contest picker.
- Configure the settings (see below).
- Click Save.
Contest Selection
Use the Contest metaobject picker (app-owned) to choose which active contest the popup should display. Only active contests appear in the picker. If no contest is selected, the popup won't render.
If this block was configured before app-owned metaobject migration, the Contest (Legacy) picker remains available and will continue to work.
Trigger Settings
Control when the popup appears:
Trigger type:
- Time delay (default) — Popup appears after a set number of seconds. Configure the delay from 1 to 60 seconds (default: 5 seconds).
- Scroll percentage — Popup appears when the visitor scrolls to a certain point on the page. Set from 10% to 100% (default: 50%).
- Exit intent — Popup appears when the visitor moves their cursor toward the browser's close/back button, signaling they may leave.
Frequency Settings
Control how often the popup appears to the same visitor:
- Once per visitor — Shows once, then never again (uses local storage).
- Once per session (default) — Shows once per browser session.
- Once per day — Shows once every 24 hours.
- Always — Shows on every qualifying page load.
Remember when dismissed: When enabled (default: on), if a visitor closes the popup, it won't show again regardless of the frequency setting.
Page Targeting
Choose which pages show the popup:
- Show on all pages (default: on) — Popup can appear on any page.
Or target specific page types:
- Homepage (default: on)
- Product pages (default: on)
- Collection pages (default: on)
- Cart page (default: off)
When "Show on all pages" is disabled, only the individually checked page types will show the popup.
Display Options
Toggle what content appears in the popup:
- Show contest title (default: on)
- Show description (default: on)
Prizes, dates, terms visibility, button text, and success message are controlled from the contest's Design tab.
Style Settings
Popup colors, CTA text, and success message are inherited from the contest's Design tab.
Popup-specific style options:
- Popup style — Choose between Centered modal (default full-screen overlay) and Bottom-right slide-in (less intrusive desktop card)
- Overlay color — The dimmed background behind the popup
- Popup width — 300px to 600px (default: 450px)
- Border radius — 0px to 24px (default: 8px) — controls how rounded the popup corners are