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

# Spin to Win

> The Spin to Win turns an age-old favorite into completely customizable gamified content - the ultimate way to engage & reward your audience.

## What is it?

The Spin to Win is a way to instantly reward users through a virtual spin-the-wheel experience.

## How do I build one?

### Step 1: Add a Spin to Win to your Hub

<img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/spin-to-win-step-1-add-a-step-1.gif?s=591320f69cba39d6040edf2b7536e013" alt="Spin to Win: step 1 — Step 1: Add a Spin to Win to your Hub" width="2000" height="1088" data-path="images/spin-to-win-step-1-add-a-step-1.gif" />

* Navigate to your **Engagement Hub**.
* Once there, click the **Plus icon,** select **Games** and then **Spin to Win.** - Input an **internal name** for the card and click **Add.** - You will then see your new card has been added to your Hub.

### Step 2: Add a Cover image

<img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/spin-to-win-step-2-add-a-step-2.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=345457bbf4a041e0f86718c818118b13" alt="Spin to Win: step 2 — Step 2: Add a Cover image" width="3286" height="1888" data-path="images/spin-to-win-step-2-add-a-step-2.webp" />

* **(1)** This is where you can upload a **cover image.**
* **(2)** Clicking on the **call-to-action button** will allow you to edit the copy and colours of this section, **(7)** or you can **disable** this here.
* **(3)** Set the **outer card shell colours** (description and share bar).
* **(4)** You can add an **author** tag by displaying the brand or person who's responsible for the card content.
* **(5)** Add an optional **description** to the card by toggling this on in the righthand toolbar.
* **(6) Here you can enable a title.**

### Step 3: Add a Data capture form

* **(1)** Data capture is **required** for this card. This will be on by default but will require you to configure additional settings.

<Card title="Ready to set up your competition?" icon="sparkles" href="/getting-started/hub-setup/data-capture/index" cta="Click here" />

<Tip>
  Within this card, you can alter the communications within the data capture and when setting up the prize screens.
</Tip>

### Step 4: Set up your Gameplay screens

<img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/spin-to-win-step-4-set-up-step-4.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=493f351695ac9bfe4a1595c45a3ddfa0" alt="Spin to Win: step 4 — Step 4: Set up your Gameplay screens" width="3284" height="1888" data-path="images/spin-to-win-step-4-set-up-step-4.webp" />

* Here is where you will set up all the screens which will be seen by your users.
* **(1)** To create a new spin wheel wedge, click on **Add Result**. This will open the wedge and result screen editing modal.

  <Accordion title="Adding Wedges and Result Screen">
    <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/spin-to-win-step-4-set-up-option-a.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=c3f3320ddbd38b0c20b73b9074b20764" alt="Spin to Win: option a — Step 4: Set up your Gameplay screens" width="1616" height="956" data-path="images/spin-to-win-step-4-set-up-option-a.webp" />

    * **(A)** Using the result screen editor, **title** your result (in most cases, this result would be how you reveal a prize or reward to your user).
    * **(B)** Upload an **image** to reflect your result.
    * **(C)** Add an optional **description** that explains the prize or next steps.
    * **(D)** Here you can add a **call-to-action button** to your result screen with an external URL.
    * **(E)** Navigate to the righthand toolbar and give the result an **internal name**.
    * **(F)** Here you can also enable a pop of **confetti** on the reveal.
    * **(G)** Enable users to **play again.** - **(H)** Add a **Back to Hub** button.
    * **(I)** To style your wedge, input the **text** that will display on the spin wheel, edit the **wedge and text colour** and enter the number of times you'd like to wedge to be **repeated** on the spin wheel.
    * **(J)** In the next step, we'll show you how to configure your wedge colour palette so that your wedges will automatically shift through a pre-selected list of brand colours. However, you can also choose to **override the wedge colour** for a particular result by **toggling this on in your Wedge Styling settings** and configuring the wedge and text colour as you wish.
    * **(K)** Input the number of times you want this particular wedge to **repeat** on the spin wheel. You can leave this as 1.
    * Repeat this step for every Wedge you create.
  </Accordion>
* **(2)** Repeat the steps above to set up the **Failure screen.**

### Step 5: Configure prizes, limits & probabilities

<img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/spin-to-win-step-5-configure-prizes-step-5.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=4414079e1b6367f4cdf33392732aaa15" alt="Spin to Win: step 5 — Step 5: Configure prizes, limits & probabilities" width="3228" height="1832" data-path="images/spin-to-win-step-5-configure-prizes-step-5.webp" />

* **(1)** You can return to **edit** the prize screen and communications here.
* **(2)** You can set the **maximum number** of times this prize can be won here. \
  **Note:** Once the allocation for this prize has been used up all probability associated with this will be reverted to the **failure screen**.
* **(3)** Here you will set the **percentage probability** that a user will see this. **Note:** This probability is shared across all the prizes you set up. e.g. you cannot have two prizes with a probability of over 50.
* **(4)** To add a prize and communications to a particular wedge, click **Add Prize**.

  <Accordion title="Adding Prizes">
    <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/spin-to-win-step-5-configure-prizes-option-a.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=77167243e20f46e4503f2ccb098dab76" alt="Spin to Win: option a — Step 5: Configure prizes, limits & probabilities" width="3232" height="1830" data-path="images/spin-to-win-step-5-configure-prizes-option-a.webp" />

    * **(A)** Here, you can **add an extra data form** to a particular prize wedge. \
      **Note:** This extra data capture form is perfect for getting that extra piece of information that you don't necessarily need unless a user lands on a prize wedge, i.e. their postal address to send them their prize. If you need guidance on setting up a Data Capture form, check out [**this article**](/getting-started/hub-setup/data-capture).
    * **(B) + (C)** Add **email communications** and/or **SMS communications** to each prize. Here you can attach coupons, link them to an external reward or provide the next steps. If you need guidance on setting up prizes and communications, head to [**this article**](/competitions-promotions/setup-management/prizes-and-comms).
  </Accordion>

### Step 6: Style your Spin to Win

<img src="https://mintcdn.com/komotechnologies/YBuAsk8OUeUukWbG/images/eef.webp?fit=max&auto=format&n=YBuAsk8OUeUukWbG&q=85&s=6db9fb251ab3bdd906c36b39d3cf4063" alt="Spin to Win: option b — Step 6: Style your Spin to Win" width="3228" height="1832" data-path="images/eef.webp" />

* **(1)** To edit the **Header Bar** of your game, click on the header. Here you can change the header background color, close button color and add your logo to the top of your Spin to Win.
* **(2)** Add a **title** to your game by inputting text above the spin wheel.
* **(3)** Add an optional **description** to your game by inputting text here.
* **(4)** Navigate to the righthand toolbar to the **Background** dropdown menu.

  <Accordion title="Styling Backgrounds">
    <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/spin-to-win-step-6-style-your-option-a.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=d394e4472c3df619ff5754b18f4b194d" alt="Spin to Win: option a — Step 6: Style your Spin to Win" width="3228" height="1832" data-path="images/spin-to-win-step-6-style-your-option-a.webp" />

    * **(A)** Here you can edit the **background and text color** of your title and description.
    * **(B)** Alternatively, upload a **background image**.
  </Accordion>
* **(5)** Navigate to the **Border** dropdown menu.

  <Accordion title="Styling Borders">
    <img src="https://mintcdn.com/komotechnologies/hyNEub_8vkzR1bhF/images/4ed.webp?fit=max&auto=format&n=hyNEub_8vkzR1bhF&q=85&s=e85f92072f6462bde0c3c063d0d4d67e" alt="Spin to Win: option a — Step 6: Style your Spin to Win" width="3228" height="1832" data-path="images/4ed.webp" />

    * **(A)** Here you can choose a solid-colored **border** or our classic spin wheel style.
    * **(B)** Alter the **border width** here.
    * **(C) Here you can configure the color** of your border.
  </Accordion>
* **(6)** Here you can change the **border color** of the wheel.
* **(7)** Alter the **width** of the wedge borders inside the spin wheel.
* **(8)** Edit the colors of the **ticker** located at the top of the wheel.
* **(9)** add an **image** to replace the spin button or **(10)** change the colors of the **spin button**.
* **(11)** Here is where you can set the **default colors for your wedges.** This will mean that your wedges will be pre-filled with your branding colors and the wedges will switch between these automatically as opposed to manually selecting a color for each wedge.

  <Accordion title="Customising Default Wedge Colours">
    <Note>
      This is not required if you have overridden the colors of your wedges in Step 4.
    </Note>

    <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/refdc.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=456b5b0984e17936240fb05e0b901449" alt="Spin to Win: step 4 — Step 6: Style your Spin to Win" width="3228" height="1832" data-path="images/refdc.webp" />

    * **(A)** **By clicking on the edit icon**, you can change the **background and text color** of your wedges.
    * **(B)** Clicking here will **delete** your selected wedge color.
    * **(C)** Clicking here will **add a new wedge color**.
  </Accordion>

### Step 7: Publish your Card

<img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/spin-to-win-step-7-publish-your-option-c.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=7596f554efca3bb0c33be8da203c41a6" alt="Spin to Win: option c — Step 7: Publish your Card" width="3264" height="1964" data-path="images/spin-to-win-step-7-publish-your-option-c.webp" />

**Once you've completed all of these steps, played around with your card and are happy with all the aspects of your card, it's time to get your card live!**

* **(1) Publish** your card manually and instantly for the world to see.
* **(2) Schedule** your card to be published and unpublished at set dates and times.
* **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. See how to test your card [here](/getting-started/hub-setup/card-testing).

<Note>
  All competition entries will be recorded and will impact the card analytics.
</Note>

## "Go Live" Checklist

Ready to go live with your Spin to Win? We recommend reviewing the following list before launching and double-checking that you have:- All images uploaded to each screen are the **correct dimensions**. Export image files in 2x to ensure none of the images appear pixelated.

* Hyperlinked your [T\&C's](/getting-started/resources/terms-conditions) to the opt-in-field, which is created in the **data capture** section of the settings tab.
* All your **communications** (Prize screen/s and Fallback screen/s) fully set up and ready to send.
* Made sure the coupons you've used (if any) are set up correctly. Check the coupon limits are set, the copy for each screen is right and you have linked the appropriate coupons to your communications.
* Ensured you have set the **probability** for each result screen.
* Ensured you have set the **limits** for each result. - Edited the **Styling** of the Spin to Win to your branding. - Checked that your spin wheel is configured to your desired order of wedges by viewing it in the Styling tab.
* Ensured that if you have multiple result screens, each have an **internal name** to help you distinguish between the prizes in the analytics.Then you're ready to go live!

<Columns cols={2}>
  <Column>
    <Card title="Terms & Conditions Template" color="#F1E52C" icon="file-lines" href="https://docs.google.com/document/d/1jlw9yak8WTnwMz5ZJTopu1kfG6U-NF0B/copy" cta="Download Template" />
  </Column>

  <Column>
    <Card title="Card Design Guidelines" color="#F1E52C" icon="cards-blank" href="https://docs.google.com/presentation/d/1WItZyUKPJznQLhwg4WrehIj3i6d91GXPDu-xinJ3ohU/edit?usp=sharing" cta="Learn More" />
  </Column>
</Columns>

## Promotion

<Card title="Stuck on how to promote your activation?" color="#F1E52C" icon="megaphone" href="/getting-started/promotion/promoting-your-engagement-hub/index" cta="Click here!" />

## FAQ

**Is there a limit to the number of wedges I can have on the spin wheel?**

You can have as many wedges as you'd like. Just keep in mind that the more you add, depending on your text input, the more the spacing and sizing will be limited.

**How many prizes can I have?**

You can have as many prizes as you like. The only exception is that the probability of winning all prizes combined must not be greater than 100.

## Top tips

* Include a bit of information in your cover image. Mention what prize/s can be won. This will get users to engage more as they know the prize/s. You can add this information on the top of the card instead by using the **Options** button located at the bottom of the card and selecting **Description**.
* Set up communications for prize winners in the Result screen section. After designing the Prize Result screen, on the left, you can set up SMS or Email communications. These communications will be sent out instantly when a user has won.- The communications tab in the Data capture section is an overview of all communications set up for the game.- Direct users back to the Hub in the Failure screen to compete in more competitions and games. Drive more traffic and engagement to your Hub.
* Set the probability of seeing a result screen accordingly. If you have a couple of prizes to give away, set the probability lower so you don't reach your prize limit too soon and can drive more traffic to your Hub. If your game is active for a certain period of time, set the probability a bit higher to reach your prize limit.
