> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Spin wheel

> A prize wheel that reveals your own discount codes, with every prize and its odds listed. Off on install.

The spin wheel is a promotion you turn on yourself. It never creates or checks discount codes: it shows a code you made in Shopify, picked at random with the odds you set, and it lists every prize and its odds so shoppers know what they can win.

**1. Create the codes.** In Discounts, create one code per prize, for example 10% off with the code NUIT10. Give each an end date and limit it to one use per customer.

**2. Write the terms.** Create a page with the rules of each prize: end date, minimum spend and one use per customer.

**3. Add the prizes.** In the theme editor open any page, then select Spin wheel under Overlays in the sidebar. Add a Prize block per code (2 to 8 segments in all):

* Label on the wheel: short, up to about 16 characters, for example 10% off;
* Discount code: exactly as created in Discounts;
* Weight: sets the odds. A prize's chance is its weight divided by the total of all weights.

Add a Segment without a prize block if not every turn should win. It is listed with its odds, and the wheel stops saying every turn wins.

**4. Choose how it opens.**

* Show tab on the left: a tab with your Tab label on large screens, a slim star below 1200 px. On phones it shows only over the first screen of pages with a hero film, and it tucks away while shoppers scroll down.
* Footer and menu links: tick Add a link to the spin wheel on a footer Menu block; the menu drawer gets one automatically.
* Open by itself after: 0 to 120 seconds; 0 opens it only from the tab and links. It never opens by itself on the cart, account, contact or password pages.
* Show again after: the days before a visitor who spun or closed the wheel can spin again or sees it open by itself again (default 30).

**5. Email, only with consent.** Asking for an email is optional. Shopify's customer form subscribes every address it receives, so the wheel sends an address only when the visitor ticks the consent box, which is never ticked in advance. With Require an email address on, visitors must give an address and tick the box to spin. Check this is allowed where you sell. Addresses are tagged spin-wheel in Customers.

**6. Turn it on.** Choose Terms of the offer, tick Enable spin wheel, and show the section with the eye icon in the sidebar.

![The spin wheel](https://mintcdn.com/kwebby/Y7lUE3PaLXfHjaRp/images/vesper/spin-wheel.webp?fit=max\&auto=format\&n=Y7lUE3PaLXfHjaRp\&q=85\&s=c68fffac8d0b834eb99d57125d251b1b)

The spin wheel with its prizes and odds

**What shoppers see.** The wheel spins once, then shows the prize and the code with a Copy button and your Note under the code. Visitors who ask for reduced motion see the result straight away. The theme does not email the code.

> [!WARNING]
>
> Discount codes are in the page source, so anyone can read them. Treat them as public: limit each to one use per customer and give it an end date. When an offer ends, remove its prize or turn the wheel off.

## In the theme editor

![Spin wheel in the theme editor](https://mintcdn.com/kwebby/ipMVAv6ECVUC3DoM/images/vesper/editor-spin-wheel.webp?fit=max\&auto=format\&n=ipMVAv6ECVUC3DoM\&q=85\&s=4e49a75bddcdffd33712cf567e03f094)

1 Spin wheel, under Overlays · 2 its settings. While it is selected, the wheel opens in the preview.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.