> ## 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.

# Scratch and Win

> Instantly reward users with prizes.

## What is it?

The Scratch and Win allows you to set probabilities and instantly reward users through a fun and engaging experience.

## How do I build one?

### Step 1: Add a Scratch and Win to your Hub

<img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/scratch-and-win-step-1-add-a-step-1.gif?s=390949f71bf2491049120f260987b607" alt="Scratch and Win: step 1 — Step 1: Add a Scratch and Win to your Hub" width="2000" height="1086" data-path="images/scratch-and-win-step-1-add-a-step-1.gif" />

* Navigate to your **Engagement Hub**.
* Once there click the **Plus icon,** from here select **Games** and then **Scratch and Win.**
* 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/scratch-and-win-step-2-add-a-step-2.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=8704747e92442b239be5f87392e47995" alt="Scratch and Win: step 2 — Step 2: Add a Cover image" width="3280" height="1884" data-path="images/scratch-and-win-step-2-add-a-step-2.webp" />

* Clicking on the **Scratch and Win** will open the editing module.
* **(1)** This is where you can upload a **cover image**.
* **(2)** Here you can edit the color and copy of the **call-to-action bar** or **(7)** toggle this off 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 a **description** to the card.
* **(6) Here you can enable a title**.

### Step 3: Add a Data capture

**Data capture** is required for this card, this will be on by default but will require you to set up additional settings.

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

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

### Step 4: Set up your Scratch screen

<img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/scratch-and-win-step-4-set-up-step-4.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=1db96ea4c754d699ee192fe555806e2e" alt="Scratch and Win: step 4 — Step 4: Set up your Scratch screen" width="3286" height="1890" data-path="images/scratch-and-win-step-4-set-up-step-4.webp" />

* **(1)** Here you will be able to upload the **image** that your users will need to scratch to reveal a result.
* **(2)** Here you can give more context to your users with a **description**.
* **(3)** Set the **percentage** of how much the screen needs to be scratched off to reveal the user's result.
* **(4)** Style the gameplay experience here.

  <Accordion title="Styling Gameplay Experience">
    <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/scratch-and-win-step-4-set-up-option-a.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=16fd59d98f934a5110d8532395de5dff" alt="Scratch and Win: option a — Step 4: Set up your Scratch screen" width="3282" height="1886" data-path="images/scratch-and-win-step-4-set-up-option-a.webp" />

    * **(A)** Edit the **header bar** by uploading your logo and brand colors.
    * **(B)** Here you can enable a **title** for the scratch screen.
    * **(C)** Alter the **gameplay background and text** colors.
    * **(D)** You can upload a **background image** here.
  </Accordion>

### Step 5: Set up your Result screens

<img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/scratch-and-win-step-5-set-up-option-d.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=6e26196333faf1a5524362b2d2cf7ed1" alt="Scratch and Win: option d — Step 5: Set up your Result screens" width="3286" height="1888" data-path="images/scratch-and-win-step-5-set-up-option-d.webp" />

* Click on the **Results** tab.
* **(1)** Here is where you will add a **prize result**.

<Accordion title="Adding Prize Results">
  <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/scratch-and-win-step-5-set-up-option-a.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=5fca3e0ad74d12fdd66736be9d65563c" alt="Scratch and Win: option a — Step 5: Set up your Result screens" width="1602" height="987" data-path="images/scratch-and-win-step-5-set-up-option-a.webp" />

  * **(A)** Here you will upload an **image** for the winning screen.
  * **(B)** Give context to your users with a **title** and **(C)** a **description.**
  * **(D)** You can add a **button** to direct users to external sites.
  * **(E)** Here you can give this prize an **internal name** for analytics purposes.
  * **(F)** You have the option to **disable confetti effects.**
  * **(G)** Here you can ask for **additional information** from users when they are awarded this prize e.g. if you want to send prizes/items directly to the winner(s), you can ask for their address. The Extra data form is optional as this will depend on your prizes and how you plan on awarding them. <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/scratch-and-win-step-5-set-up-option-a-3.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=988a47058ea9a6db802afe88b9b64799" alt="Scratch and Win: option a — Step 5: Set up your Result screens" width="1286" height="809" data-path="images/scratch-and-win-step-5-set-up-option-a-3.webp" />
    * **(a)** Click here to upload a header **image**.
    * **(b) + (c)** Here you can customize the **copy** within the form.
    * **(d)** You can add fields by clicking the **plus icon.** These are your **data fields** and comprise the information the user will need to supply in order to claim their prize.
    * **(e)** Ability to alter the **color and copy** of the bar.
    * **(f)** Apply additional settings to **control** when the extra data form appears based on a user's form entry.
    * **(H) + (I)** Here we can set up the correlating **communications**.
      <Note>
        If you wish to send SMS communications, you need to have a Twilio account. [Learn more about sending SMS through Komo here.](/getting-started/hub-setup/sms-sender-ids)
      </Note>
</Accordion>

* Once you have set up your prize and communications you can close its model to edit more settings regarding this prize.

<Accordion title="Results Screen Settings">
  <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/scratch-and-win-step-5-set-up-option-a-4.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=1c17716af73467ae6863651deee3e87b" alt="Scratch and Win: option a — Step 5: Set up your Result screens" width="3286" height="1888" data-path="images/scratch-and-win-step-5-set-up-option-a-4.webp" /> **(A)** You can return to **edit** the prize screen.

  * **(B)** 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**.
  * **(C)** 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.
      </Note>
  * **(D)** Here you will see the **total number** of users that have won this prize so far.
  * **(E)** Here will indicate what sort of **communications** you have set up for this particular prize e.g. SMS or Email.
  * **(F)** You can **delete** this specific prize here.
  * **(G)** Clicking the **Plus** icon will allow you to add additional prizes.
</Accordion>

* **(2)** Here you will set up the **failure/fallback screen**

  <Accordion title="Setup the Fallback Screen">
    <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/scratch-and-win-step-5-set-up-option-a-2.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=8a8ad3523a9abf8ba3e5ea4b85db2365" alt="Scratch and Win: option a — Step 5: Set up your Result screens" width="1602" height="988" data-path="images/scratch-and-win-step-5-set-up-option-a-2.webp" />

    * **(A)** Here you will upload an **image** for the failure screen.
    * **(B)** Give context to your users with a **title** and **(C)** a **description.**
    * **(D)** You can add a **button** to direct users to external sites.
    * **(E)** Here you can give this prize an **internal name** for analytics purposes.
    * **(G) + (H)** Here we can set up the correlating **communications**.
        <Note>
          If you wish to send SMS communications, you need to have a Twilio account. [Learn more about sending SMS through Komo here.](/getting-started/hub-setup/sms-sender-ids)
        </Note>
  </Accordion>

### Step 6: Set up your Styling

<img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/scratch-and-win-step-6-set-up-step-6.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=8dbf2eb0f8f5c4c28c50bb5148098476" alt="Scratch and Win: step 6 — Step 6: Set up your Styling" width="3284" height="1882" data-path="images/scratch-and-win-step-6-set-up-step-6.webp" />

* The styling refers to everything your user will see whilst engaging in the game.
  <Note>
    If you set up the styling settings under the Scratch screen, it will follow through for the full gameplay experience. Any updates made here will apply to the other screens.
  </Note>
* **(1)** Here you will see a **preview** of your pre-game content set up in the previous steps.>
  <Note>
    You will not be able to edit anything for this section.
  </Note>
* **(2)** Here you can change the **color of the copy** and call to action or **(3)** disable the button here.
* **(4)** Enable the **play again button** or disable the **back to Hub** call to action.
  <Note>
    To enable the play again button, you need to update the entry limit under the data capture section to more than a single entry.
  </Note>

### Step 7: Publish your Card

<img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/scratch-and-win-step-7-publish-your-step-7.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=c305107409b3d6605b553ff50dbc5844" alt="Scratch and Win: step 7 — Step 7: Publish your Card" width="1660" height="1035" data-path="images/scratch-and-win-step-7-publish-your-step-7.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 Scratch and Win? We recommend reviewing the following list before launching and double-checking if 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\&Cs**](/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/s screen and Failure screen) are fully set up and ready to send.
* If you are using **coupons**, make sure the coupons created 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.
* Ensure you have set the **probability** for each result screen.
* Edit the **Styling** of the game to your branding.
* If you have multiple prize screens, ensure to give each 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/1V8Yiw9auFFQ9SmoMi4rzC3d0YUqVruwx/copy" cta="Download Template" />
  </Column>

  <Column>
    <Card title="Card Design Guidelines" color="#F1E52C" icon="cards-blank" href="https://docs.google.com/presentation/d/1KcMYm7nKGSHPSEqrDgfA4LV5FVt1BDId3ejUp47zfM8/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

**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

* Set the scratch percentage between 20%-40%. If it is set too high this means your audience will need to scratch most of the image in order for the game to end, they will see the result but may need to continue scratching for the game to end...
* 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 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.
* 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.
* Creating a 'three-in-a-row' type of scratch game. You can create a screen where users need to find 3 of X items in a row to win to make it more interesting!
