> For the complete documentation index, see [llms.txt](https://docs.rafflex.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rafflex.io/create-your-first-raffle/instant-win-games/coin-flip.md).

# Coin Flip

A 3D coin toss game where customers flip a coin for each ticket and watch it land on WIN or NO WIN, with themed rooms, an animated host and shareable win cards.

***

### What Is It?

Coin Flip turns every ticket into a coin. Customers toss their coins across a 3D table and watch them spin through the air before landing face up. A coin that lands on **WIN** reveals a prize. A coin that lands on **NO WIN** means that ticket was not an instant winner.

The game is set in a choice of themed rooms, each with its own coin, music and an animated host who reacts to every toss. Up to five coins are tossed together, winning coins are lifted up to the camera to show off their prize, and at the end customers can save a personalised win card to share on social media.

{% hint style="info" %}
In the **Game Type** dropdown, Coin Flip appears as **Coin Flip (New)**.
{% endhint %}

***

### Before You Start

The game only appears for customers when the competition has **at least one instant win**. If a competition has no instant wins, customers see their ticket numbers as normal but no game is played. See [Add Instant Wins](https://docs.rafflex.io/create-your-first-raffle/add-instant-wins.md) to set up your prizes.

{% hint style="success" %}
**Add an image to each instant win prize.** When a coin lands on WIN, the prize image is shown on the face of the coin as it is lifted up to the camera, and it appears on the customer's share card too. It makes every win far more exciting.
{% endhint %}

***

### Set It Up

1. In the admin panel, find the **Competitions** group in the left-hand menu and click **Competitions**.
2. Click **New Competition**, or click an existing competition to edit it.
3. In the right-hand column, find the **Game Type** dropdown and choose **Coin Flip (New)**.
4. A **Coin Flip Settings** box appears just below it. It is split into four sections, **Look**, **Gameplay**, **Text** and **Sound**. Each section starts folded up, so click its heading to open it.
5. Change any settings you like (they are all optional and explained below).
6. Click **Create** for a new competition, or **Save changes** for an existing one.

{% hint style="info" %}
You can leave every setting at its default. Coin Flip works straight away in the **Cocktail Bar** room, with your site name engraved on the table, the host showing, background music on and built-in sounds.
{% endhint %}

***

### What Your Customers See

The game plays on the order confirmation page, straight after checkout, underneath the customer's ticket numbers.

#### Tossing the coins

1. While the room loads, the customer sees "Setting the table…". The room then appears with their first coins lined up on the table, each with its ticket number pinned in front of it (for example **#1234**).
2. Coins are tossed in groups of up to five. The main button tells the customer what will happen, for example **Flip the coin** for a single ticket or **Flip 5 coins** for a group.
3. The customer presses the button. The coins spin up into the air (the button reads "In the air…") and land on the table one by one.
4. **If a coin lands on WIN,** the win sound plays and the host celebrates. The winning coin is lifted up to the camera (showing the prize image on its face, if the prize has one), and the prize name is shown underneath with a message such as "Landed on WIN · #1234". The button changes to **Next**, so the customer can enjoy the moment before carrying on.
5. **If a coin lands on NO WIN,** the host reacts and the next group of coins is set out on the table.
6. Good runs are called out on screen, such as **Double win!**, **Triple win!**, **Hot streak ×2** or **Clean sweep!**. These simply celebrate results that have already happened.
7. The customer keeps flipping until every ticket has been tossed.

{% hint style="info" %}
**The toss is just for show.** Each ticket's result is already decided the moment the order completes. However the customer tosses, a winning ticket always lands on WIN and every other ticket always lands on NO WIN.
{% endhint %}

#### Speeding things up

Customers with lots of tickets have two shortcuts:

* **Flip the rest.** This button appears when an order has more than five tickets. It tosses every remaining group automatically, one after another, calling out each prize as it goes without stopping. Pressing it again (it now reads **Flipping everything**) speeds the tosses up further, with extra lightning bolts on the button each time. The button also shows how many coins are left to flip, for example **×12**.
* **Skip to results.** This link appears while more than five tickets are still to be flipped. It skips the tossing completely and goes straight to the results.

#### Full screen and phones

* A **Play full screen** link under the buttons, and a full screen button in the top right corner, let the customer expand the game to fill their screen. They can shrink it back with the same button or by pressing Escape on a keyboard.
* On a phone in full screen, the customer can **swipe up** on the table to throw the coins, just like flicking a real coin. A hand animation and the words "Swipe up to flip" show them how the first time, and the main button changes to **Or tap to flip** for anyone who prefers to tap. On phones that support it, the device gives a small buzz as the coins are thrown and when they land.

#### The finish screen

Once every coin has landed:

1. **If the customer has won,** their winning coins drop into a stack in the middle of the table and the top coin rises to show off the final prize (this happens on devices showing the 3D table). The finish screen then shows **One winner** (or **3 winners** and so on), "You won 1 prize." (or "You won 3 prizes."), and a list of each winning ticket number and its prize.
2. **If nothing was won,** the finish screen shows **All flipped** with your losing message underneath. If you have not written one, it reads "No luck this time" and reminds the customer that every ticket still runs in the main draw.

#### Share my win

When a customer has won, a **Share my win** button appears on the finish screen.

1. The customer presses **Share my win**. After a moment ("Preparing…") a **Share your win** window opens with a win card made just for them.
2. The card shows a picture of the table as their last coin landed, your logo across the top (or your site name if you do not have a logo), a headline such as "I won!" or "I won 3 prizes!", up to three of the prizes they won, how many coins they flipped, and the image of their most recent prize that has one.
3. Step 1 asks them to save the card. On a computer they press **Save image** to download it. On a phone they can press **Save image**, or press and hold the card, or take a screenshot.
4. Step 2, "Post it and tag us.", shows buttons for your own social media pages. Each button opens your page in a new tab, so the customer can post their card and tag you.

The social buttons come from your **Social Links** settings (in the admin panel, open **Settings**, then the **Marketing** tab). Facebook, Instagram, X, TikTok and YouTube are supported. A button only appears when that link points to an actual page or profile, so if a field is empty, or holds just the platform's home page address, its button is left out. If none of your links are set up, step 2 is not shown. See [Connect Your Social Accounts](https://docs.rafflex.io/additional-settings/settings/connect-your-social-accounts.md) to add them.

{% hint style="success" %}
Share cards are free advertising. Fill in your social links and make sure your logo is uploaded (see [Add Your Logo](https://docs.rafflex.io/customise-your-site/add-your-logo.md)) so every shared win shows your brand and points people back to you.
{% endhint %}

#### Sound

* The **mute** button in the top right corner of the game switches every sound, including the music, on or off. The customer's choice is remembered on that device for next time.
* Browsers do not allow sound to play until the customer interacts with the page, so the background music starts after their first tap or click. It plays quietly underneath the game sounds and pauses if the customer switches to another tab.

#### Older phones and data saver

Coin Flip is a 3D game, so it needs a reasonably modern browser.

* If a customer's device cannot show the 3D table, the game still works. Their coins are flipped and their results are shown without the 3D animation, so no one misses out on finding out whether they have won.
* If a customer has **data saver** switched on in their phone or browser, the 3D table is not loaded, to save their data. They see the message "Data saver is on, so the 3D table is off." with a **Load it anyway** link if they would like to see it.

***

### Customisation Options

All of Coin Flip's settings live in the **Coin Flip Settings** box, directly under the **Game Type** dropdown on the competition's edit page. Click a section heading (**Look**, **Gameplay**, **Text** or **Sound**) to open it.

#### Look

| Setting                   | What it does                                                                                                                                  | Default          |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| **Table Theme**           | Chooses the room the game is played in. The note underneath reads "Each room has its own coin and host. The coin uses your branding colours." | **Cocktail Bar** |
| **Show The Host**         | Shows the animated host who works the room and reacts to each toss. Switch it off for a quieter table with just the coins.                    | On               |
| **Engraved On The Table** | What is engraved into the table in front of the coins. Choose **Site name** or **Nothing**.                                                   | **Site name**    |
| **Win Face**              | Your own artwork for the WIN side of the coin. The note underneath reads "Square PNG works best."                                             | Built-in design  |
| **Lose Face**             | Your own artwork for the NO WIN side of the coin. The note underneath reads "Square PNG works best."                                          | Built-in design  |

**The three rooms**

| Room             | What it looks like                                                                                                    |
| ---------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Cocktail Bar** | A stylish bar with a bartender behind it. The coin is a minted metal coin in shades of your site's **Primary Color**. |
| **Casino**       | A casino table run by a dealer. The coins are casino chips in gold tones.                                             |
| **Neon Lounge**  | A glowing neon lounge hosted by a robot. The coins are glowing, see through holographic coins.                        |

Each room also comes with its own background music track (see **Sound** below). See [Choose Site Colours](https://docs.rafflex.io/customise-your-site/choose-site-colours.md) for how to set your **Primary Color**.

**Engraved On The Table**

* **Site name** engraves the **Site Name** from your general settings into the table. Very long names are shortened to fit. See [General Settings](https://docs.rafflex.io/additional-settings/settings/general-settings.md) to change your site name.
* **Nothing** leaves the table plain. Your site name is also left off the share card in this case, although your logo is still used on the card if you have uploaded one.

**Win Face and Lose Face**

Upload an image to replace the design in the middle of that side of the coin. The coin keeps its rim around your artwork.

* **Format:** an image file. A square PNG works best.
* **Max file size:** 872KB.
* Keep the important part of your design in the centre, because the image is fitted inside the round face of the coin and the corners will not be seen.
* When you upload a face image, it is shown instead of that side's label on the coin itself. The label is still used in the on screen messages (for example "Landed on WIN").
* Any transparent areas inside the face show as white, so a full colour square image usually looks better than a cut out logo.

{% hint style="info" %}
When a coin lands on WIN and is lifted up to the camera, it shows the image of the prize won, if that prize has one. Your **Win Face** is what customers see on the table the rest of the time.
{% endhint %}

#### Gameplay

| Setting                 | What it does                                                                                                                                               | Default |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| **Hide Ticket Numbers** | Hides ticket numbers throughout the game: the numbers in front of each coin, in the "Landed on WIN" messages and in the list of wins on the finish screen. | Off     |
| **Start Full Screen**   | The note underneath reads "Opens the game filling the screen. Players can still shrink it back into the page."                                             | Off     |

{% hint style="info" %}
**When to use these.** Turn on **Hide Ticket Numbers** if your customers tend to buy large orders and you would rather keep the table clean. Customers can still see all their ticket numbers above the game on the order confirmation page. Turn on **Start Full Screen** if most of your customers play on phones, so the game feels like an app from the first moment.
{% endhint %}

#### Text

| Setting            | What it does                                                                                                                                                            | Default              | Limit          |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | -------------- |
| **Win Label**      | The word on the WIN side of the coin, also used in messages such as "Landed on WIN".                                                                                    | WIN                  | 12 characters  |
| **Lose Label**     | The word on the NO WIN side of the coin.                                                                                                                                | NO WIN               | 12 characters  |
| **Losing Message** | Shown on the finish screen when none of the customer's tickets won. The note underneath reads "Leave blank to remind players their tickets are still in the main draw." | A main draw reminder | 120 characters |

A few things worth knowing:

* Labels are always shown in capital letters, so "Winner" appears as **WINNER**.
* Short labels look best on the coin. Something like **JACKPOT** or **TRY AGAIN** works well.
* The **Losing Message** is plain text on a single line. Use it to keep customers positive, for example "Your tickets are still in the main draw on Friday. Good luck!".

{% hint style="warning" %}
**Keep your losing message accurate.** Only mention a main draw if the competition really has one, and avoid promising anything you cannot deliver.
{% endhint %}

#### Sound

This section's note reads "Optional MP3s. Leave blank for the built-in sounds."

| Setting                   | What it does                                                                                               | Max file size |
| ------------------------- | ---------------------------------------------------------------------------------------------------------- | ------------- |
| **Background Music**      | Your own music track. The note underneath reads "Replaces the room's own track. Leave blank to keep it."   | 2048KB        |
| **Play Background Music** | Switch off for no background music at all, whether it is the room's own track or yours. On by default.     |               |
| **Toss Sound**            | Plays as the coins are thrown into the air.                                                                | 200KB         |
| **Landing Sound**         | Plays as each coin lands on the table.                                                                     | 200KB         |
| **Win Sound**             | Plays when a toss includes a winning coin, and again if the customer skips straight to results having won. | 200KB         |

All sounds must be **MP3** files. To go back to a built-in sound, remove your upload and save the competition again.

{% hint style="success" %}
**Sound tips.**

* Pick a background track that loops smoothly and sits in the background. It plays quietly underneath the game.
* Keep the toss, landing and win sounds short. Up to five coins land in quick succession, and the sounds speed up when customers press **Flip the rest**, so long sounds will overlap.
* Only use music and sounds you have the rights to use on your website.
  {% endhint %}

***

### Tips for a Great Coin Flip Game

* **Use short prize names.** Prize names appear under the winning coin, in the finish screen list and on the share card, so "£500 Cash" reads better than a long description.
* **Match the room to your brand.** The **Cocktail Bar** coin picks up your **Primary Color**, so it is the easiest room to make feel like your own. The **Casino** and **Neon Lounge** rooms have a strong look of their own.
* **Check it on a phone.** Most customers will play on their phones, often in full screen. Use the mobile view in **Preview Game** (below) to make sure everything looks right.

***

### Want to try it first?

Once the competition has been saved, a **Preview Game** button appears just under the **Game Type** dropdown. Click it to open the **Game Preview** page, where you can play Coin Flip with your own settings before any customer sees it.

* The **Game Settings** panel on the left holds the same **Coin Flip Settings** described above. Any change you make, including a new room, label or upload, shows in the preview straight away.
* The **Live Preview** on the right plays the game with a few sample tickets, some of them winners. Nothing is entered and no one is charged.
* Use the desktop and mobile buttons above the preview to see both layouts, and the circular arrow to replay the game.
* Click **Save** when you are happy. Your changes are not applied to the competition until you do. Click **Back to competition** to return to the edit page.

{% hint style="info" %}
The preview uses your real instant win prizes, so it is most useful once you have added them. If the competition has no instant wins yet, it shows some example prizes instead so you can still check the look.
{% endhint %}

For other ways to check a game before launch, see:

{% content-ref url="/pages/llkGYVvQNWvOv6PJtv5g" %}
[Preview a Game](https://docs.rafflex.io/create-your-first-raffle/instant-win-games/test-a-game-type.md)
{% endcontent-ref %}
