The free ChilliPopup plugin does one job: it adds the ChilliPopup pixel to every front-end page of your WordPress site, tied to your workspace by a single Workspace ID. Everything else, the wheel, its prizes and odds, the four screens and the display rules, is built in the ChilliPopup dashboard and appears on your site the moment you publish, with nothing added to header.php or functions.php. This page is the setup for a WordPress or WooCommerce site: the install, where the wheel shows, a prize table built on WooCommerce coupons, the copy, the rules and the report.
WordPress sites run on content and WooCommerce stores run on coupons, and a wheel serves both: a blog trades a spin for a subscriber, and a store spreads its welcome coupon across tiers and asks for an email before it hands one over.
Install the plugin, paste the Workspace ID from your dashboard's Install screen, save. The plugin prints one asynchronous script tag on every front-end page and nothing else: no bundled CSS or JavaScript, no iframe, and a connection that survives theme switches and theme updates.
Every slice carries a coupon you created under Marketing → Coupons in WooCommerce, with its own expiry, minimum spend and usage limit. ChilliPopup never creates or applies a coupon; it reveals the code you pasted, only inside a winning result, and WooCommerce validates it at the cart or checkout.
Each prize has a win chance in percent; the leftover to 100% is the chance of a Try again. The spin is decided on our server, codes are stripped from what reaches the browser, and if the server cannot be reached the spin resolves as a loss, so a coupon never leaks from the page source.
The plugin is free in the WordPress plugin directory and needs exactly one value from you. If you have ever used a headers-and-footers plugin, this is simpler.
In wp-admin go to Plugins → Add New, search for ChilliPopup, click Install Now, then Activate. A ChilliPopup entry appears in your admin menu.
In your ChilliPopup dashboard open Install, choose WordPress and copy your Workspace ID. Paste it into the plugin's ChilliPopup screen and save; you can paste the whole install snippet and the plugin extracts the ID. Leave Load ChilliPopup on this site ticked: unticking it pauses every campaign without losing your settings.
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. Reload your site. The dashboard's Install screen shows a green Installed & live check once it detects the pixel on your domain.
Screenshots for every step: How to install ChilliPopup on WordPress →
Everything else the plugin puts on a WordPress site is on the WordPress platform page →
Use one install method only: if the snippet is also in a headers-and-footers plugin or a Google Tag Manager tag, the pixel loads twice and a spin can be rendered or counted twice.
/product/ and contains /shop/. A wheel shows on any page that matches at least one of its rules, so these two cover product pages and the shop page and never match /cart/, /checkout/ or the order-received page. Paths are the default permalinks; check yours once if they were renamed./blog/ or contains /category/, and trade the coupon slices for a download or a template pack. The wheel does not care what the prize is.player.chillipopup.com from JavaScript optimisation and purge the cache, or the wheel may never appear.Five coupons and a leftover, for a store's welcome wheel. Create each coupon in WooCommerce first, then type the labels, codes and chances into the Prizes panel exactly like this.
| Slice | Reward code | Win chance | Why it is there |
|---|---|---|---|
| 10% off | SPIN10 | 35% | A percentage discount coupon: the welcome offer most stores make anyway, so most spins land here. |
| Free shipping | SPINSHIP | 25% | A coupon with "Allow free shipping" ticked. A fixed cost to you, and the prize small baskets like most. |
| $5 off | SPIN5 | 15% | A fixed cart discount coupon with a minimum spend, so it never applies to a $6 basket. |
| 20% off | SPIN20 | 8% | The tier that gets mentioned. Rare enough to protect margin; set a minimum spend and a usage limit per user. |
| 35% off | SPIN35 | 2% | The headline slice. Two spins in a hundred, with a minimum spend, an expiry date and a usage limit of one per user in WooCommerce. |
| Try again | none | 15% (leftover) | Added by the editor as a grey slice because the prizes total 85%. Raise the chances to 100% if you would rather every spin won. |
The arithmetic reads straight off the table: with these odds, every hundred spins hand out roughly thirty-five 10% coupons, twenty-five free-shipping coupons, fifteen $5 coupons, eight 20% coupons and two 35% coupons, and fifteen visitors see the Losing screen. Change any percentage and the editor shows the new chance of not winning as you type.
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: Welcome. Spin the wheel for up to 35% off.
Sub-line: One spin per visitor. Your coupon works on today's 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}} is yours to claim.
Sub-line: Enter your email and your coupon code appears right here.
One email field and one button. The screen only appears after a win, so nobody is asked for an email in exchange for nothing.
Headline: Enter {{prize_code}} in the coupon field for {{prize_label}}.
Sub-line: It works at the cart or at checkout on orders over $30, until 31 October 2026.
Confetti is on by default here. Add a "Shop now" button pointing at your shop page; the coupon field is on the cart page, so the shopper needs a way to get there.
Headline: No coupon on this spin, but shipping is free over $75.
Sub-line: Have a look at what arrived this week.
Point the button at the shop page or a product category. A losing spin should still end somewhere useful, or it is the part of the wheel visitors remember.
A wheel carries the same display rules as every ChilliPopup popup: six triggers, targeting, frequency caps and a schedule. WordPress lays out its URLs predictably, and the page rules read them.
/product/ and contains /shop/, so the wheel opens while a shopper is browsing and never on /cart/, /checkout/ or the order-received page, which match neither rule.There is no WordPress-specific wheel template, and you do not need one. Both wheel themes are fully editable, and a wheel that looks like part of your 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. Neither lives in your WordPress database; both are in the ChilliPopup dashboard.
Plugin, theme script or Tag Manager, the page-speed question answered honestly, and a complete newsletter popup with its rules and copy.
Read the guide →Which campaign belongs on which store page, the exact URL rules to use, and how to hand out a coupon without leaking the code.
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 →Install the free plugin, paste your Workspace ID, type your WooCommerce coupons into the prize table and publish. The wheel opens on your shop and product pages, the server decides every spin, and every coupon you give away comes with an email.