ChilliPopup installs on a Shopify store as an app embed: one toggle in the theme editor, no Liquid, no theme edits. The wheel that follows is an overlay on your storefront pages, each slice carrying a discount code you created in Shopify, with the winner decided on our server rather than in the shopper's browser. This page is the whole setup for a store: the install, where the wheel shows, a first-order prize table, the copy for each screen, display rules that fit Shopify's URLs, and what to read in the report.
Shopify Discounts gives you the codes; ChilliPopup gives a shopper a reason to hand over an email before they see one. The wheel spreads a first-order discount across tiers, with a win chance you set per slice, and lives on your storefront pages without a line of Liquid.
Each prize on the wheel carries a code you created under Discounts in your Shopify admin. ChilliPopup never creates or applies a discount in your store; it reveals the code you pasted, only inside a winning result, and Shopify validates it at checkout as it would any other code.
The ChilliPopup app adds one asynchronous script tag to your theme through Shopify's app embed. Toggle it on under Online Store → Themes → Customize → App embeds, click Save, and every wheel you publish afterwards appears on your storefront. Switch it off and the tag is gone; there are no Liquid edits to revert.
Each slice has its own win chance in percent, and whatever is left of 100% is the chance of a Try again. The roll happens on our server and the wheel only animates to the result, so what reaches the browser holds labels and odds, never codes. If our server cannot be reached, the spin resolves as a loss.
The Shopify app binds your store to your ChilliPopup workspace for you, so there is no Workspace ID to paste. The step people miss is the second one.
Open the ChilliPopup app in the Shopify App Store, click Install and approve it in your Shopify admin; the app connects the store to your workspace and signs you in. Already in the ChilliPopup dashboard? Open Installation Code, choose Shopify, type your store domain (your-store.myshopify.com) and click Connect Shopify instead. Both routes end in the same place.
In Shopify go to Online Store → Themes → Customize → App embeds (the puzzle-piece icon), toggle ChilliPopup on and click Save. App embeds are off by default after any install and are stored per theme, so do this again if you switch or duplicate your theme.
In ChilliPopup pick a wheel theme, type the prize table below into the Prizes panel, write the four screens, set the display rules and set the wheel to Published; drafts never serve. Open your storefront in an incognito window and trigger the rule. The dashboard's Shopify panel reads Connected & active once the storefront has loaded the pixel.
Screenshots and troubleshooting for each step: How to install ChilliPopup on Shopify →
Everything else the app does for a store, from forms to surveys, is on the Shopify platform page →
/checkouts/./products/ and contains /collections/. A wheel shows on any page that matches at least one of its rules, so these two cover both page types and leave the home page and cart alone./cart, if you want the wheel to catch a shopper on the cart page too. Without it the cart matches nothing and stays quiet.Five prizes and a leftover, built around a first order. Each code is created in Shopify first; then the labels, codes and chances go into the Prizes panel exactly like this, and the wheel draws itself, Try again slice included.
| Slice | Reward code | Win chance | Why it is there |
|---|---|---|---|
| 10% off | WELCOME10 | 40% | The welcome offer you would have shown in a plain popup. Most spins land here, and it costs nothing extra. |
| 15% off | WELCOME15 | 22% | A visible step up on a first basket that still leaves margin on full-price items. |
| Free shipping | SHIPFREE | 18% | Created as a free shipping discount in Shopify. A fixed cost to you, and the prize small baskets like most. |
| 20% off | WELCOME20 | 8% | The tier shoppers tell friends about. Rare enough to protect margin; give the code a minimum purchase amount in Shopify. |
| 30% off | WELCOME30 | 2% | The headline slice. Two spins in a hundred, capped in Shopify with a minimum purchase amount and one use per customer. |
| Try again | none | 10% (leftover) | Added by the editor as a grey slice because the prizes total 90%. Ten shoppers in a hundred see the Losing screen, which is what keeps the other ninety codes worth having. |
The arithmetic reads straight off the table: with these odds, every hundred spins hand out roughly forty 10% codes, twenty-two 15% codes, eighteen free-shipping codes, eight 20% codes and two 30% codes, and ten shoppers see the Losing screen. Change any percentage and the editor shows the new chance of not winning as you type.
SHIPFREE. Give each the same end date as the wheel, and give the 20% and 30% codes a minimum purchase amount and a one-use-per-customer limit.A wheel has four screens: Play, Post-Play, Winning and Losing, each its own canvas in the editor. Write {{prize_label}} and {{prize_code}} anywhere in the Post-Play or Winning copy and the won prize fills them in.
Headline: New here? Spin for your first-order discount.
Sub-line: One spin, one code, up to 30% off your first order.
The disc itself is the button, so a hint like "Click the wheel to start" is all the instruction it needs.
Headline: {{prize_label}} on your first order.
Sub-line: Enter your email and your code appears right here.
One email field and one button. This screen only appears after a win, so nobody is asked for an email in exchange for nothing.
Headline: Use {{prize_code}} at checkout for {{prize_label}}.
Sub-line: Paste it into the discount code box at checkout on your first order.
Confetti is on by default here. Add a "Shop now" button pointing at the collection you want first orders to come from.
Headline: No prize on this spin.
Sub-line: New arrivals are in the shop this week, and shipping is free over $60 for everyone.
Give the shopper a button to a collection. The Losing screen is the one part of the wheel a visitor sees with nothing in return, so make it worth the click.
A wheel carries the same display rules as every ChilliPopup popup: six triggers, targeting, frequency caps and a schedule. Shopify's URL structure is predictable, which makes the page rules the easy part.
/products/ and contains /collections/. A wheel shows where at least one page rule matches, so these two cover product and collection pages and leave the home page, cart and content pages alone. The checkout never renders app embeds, so there is nothing to exclude.There is no Shopify-specific wheel template, and you do not need one. Both wheel themes are fully editable, and a wheel that looks like part of your Shopify theme is a few minutes of recolouring.
A wheel gets two reports: the popup report every ChilliPopup campaign has, and a game report built from the server's own record of each spin. Read them next to Shopify's discount report and the economics of the wheel are plain.
The step-by-step guide to popups on a Shopify store: the app embed, the campaigns that belong on each storefront page, and the rules that keep them off the checkout.
Read the guide →Prize ideas for stores and service sites, how to set the odds, whether to include a losing slice, and the prize mix that keeps a wheel profitable.
Read the guide →Where a Shopify store loses shoppers between the product page and the order, and the changes, on-site campaigns included, that move the rate.
Read the guide →Install the app, toggle the embed, type your Shopify codes into the prize table and publish. The wheel opens on your product and collection pages, the server decides every spin, and every code you give away comes with an email.