> 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/managing-competitions.md).

# Managing Your Competitions

Find, filter, reorder and manage every competition from one list, then use the tools on each competition's page to preview, duplicate, export entries, add winners and check its history.

Once your first competition is live, most of your day to day work happens in two places:

* The **Competitions list**, where you can see every competition at a glance, filter them, and set the order they appear in on your site.
* Each competition's **edit page**, which holds everything about that one competition: its settings, its sales figures, its tickets and winners, and a set of handy tools.

This page walks you through both.

***

### Open your Competitions list

In the **admin panel**, look for the **Competitions** group in the left hand menu and click **Competitions**. Your newest competitions are shown first.

Along the top of the list are tabs that group your competitions by stage, each with a count:

| Tab           | What it lists                                                                                   |
| ------------- | ----------------------------------------------------------------------------------------------- |
| **Live**      | Open for entries right now.                                                                     |
| **Scheduled** | Switched on, with a start time still to come.                                                   |
| **Draft**     | Switched off and not yet ended.                                                                 |
| **To draw**   | Ended or sold out in the last 30 days, switched on, and still waiting for its main draw winner. |
| **Ended**     | Ended or sold out in the last 30 days, with nothing left to draw.                               |
| **Archived**  | Ended more than 30 days ago.                                                                    |
| **All**       | Every competition.                                                                              |

The list opens on the tab you picked last time.

To start a brand new competition from here, click **New Competition** in the top right. See [Create a Competition](https://docs.rafflex.io/create-your-first-raffle/create-a-competition.md) for a full walkthrough.

{% hint style="info" %}
**Already on your live site?** When you are logged in as an admin, a bar appears on your website. On any competition page, click **Edit Competition** in that bar to jump straight to that competition's edit page in the admin panel.
{% endhint %}

***

### What each column shows

| Column          | What it tells you                                                                                                                                                                                                                                                                                                                                |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Title**       | The competition's name. Use the search box above the list to find a competition by its title.                                                                                                                                                                                                                                                    |
| **Price**       | The current ticket price. If a sale price is set, this shows the sale price. Free competitions show **Free**.                                                                                                                                                                                                                                    |
| **Max tickets** | The total number of tickets available.                                                                                                                                                                                                                                                                                                           |
| **Sold**        | How many tickets have been sold so far.                                                                                                                                                                                                                                                                                                          |
| **Turnover**    | How much the competition has taken. Staff members with the **Restrict Financials** restriction do not see this column.                                                                                                                                                                                                                           |
| **Starts**      | When the competition opens for entries. If the start is in the future, the date shows in amber with a clock icon. Hover over it to see "Scheduled: goes live automatically at this time (if Active)."                                                                                                                                            |
| **End**         | When the competition closes.                                                                                                                                                                                                                                                                                                                     |
| **Active**      | A tick means the competition is switched on. A cross means it is switched off and customers cannot see it.                                                                                                                                                                                                                                       |
| **Hidden**      | An eye with a line through it means the competition is a [Hidden / VIP Competition](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/hidden-vip-competitions.md). An open eye means it is public. Hover over the icon to see "Hidden from public listings, reachable only by direct link." or "Visible in public listings." |

You can sort the list by **Starts** or **End** by clicking the column heading. If you would rather not see the **Starts** column, click the **Toggle columns** button above the list and untick it.

{% hint style="info" %}
**Why is my competition not showing on my site?** Check the **Active**, **Starts** and **Hidden** columns first. A competition needs to be Active, have a start time that has passed, not be hidden, and not have ended or sold out to appear in your listings. For more help, see [Why a competition is not on my homepage](https://docs.rafflex.io/customise-your-site/set-up-your-homepage/why-a-competition-is-not-on-my-homepage.md).
{% endhint %}

***

### Filter the list

Click the **filter** icon (the funnel) above the list to narrow down what you see. You can combine filters.

* **Show Only Live Competitions** shows competitions that are Active, have started, and are still open. Ended and sold out competitions are left out.
* **Show Only Scheduled Competitions** shows Active competitions with a start date in the future. These are waiting to open. See [Schedule a Competition](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/schedule-a-competition.md).
* **Visibility** lets you choose **All competitions**, **Hidden only** or **Public only**. This is the quickest way to find your VIP draws.
* **Deleted records** lets you see competitions you have deleted. Choose **Without deleted records** (the normal view), **With deleted records**, or **Only deleted records**.

At the bottom of the list you can move between pages and choose how many competitions to show per page.

***

### Edit, delete and restore a competition

Each row has its own actions on the right:

* **Edit** opens the competition's edit page. You can also click anywhere on the row.
* **Delete** removes the competition from your site and from the list. You will be asked to confirm first.
* **Restore** appears on deleted competitions and brings them back.

{% hint style="success" %}
**Deleted by mistake? You can get it back.** Deleting a competition does not wipe it permanently. Open the filter, set **Deleted records** to **Only deleted records**, find the competition and click **Restore**.
{% endhint %}

{% hint style="warning" %}
**Thinking of deleting a competition that has sold tickets?** It is usually better to leave it to end naturally, or switch **Active** off, so your records stay tidy. Delete is best for test competitions or ones created by mistake. Deleting a finished competition also removes it, and its winners, from your Results and Completed pages. Restore it and they come back.
{% endhint %}

***

### Set the order competitions appear in

You can choose the exact order your competitions are shown in by dragging them into place.

1. In the **Competitions** list, click **Enable reordering** above the table.
2. Drag each competition up or down using the handle on the left of its row.
3. When you are happy, click **Finish**.

Your new order is saved straight away.

{% hint style="info" %}
**When is this order used?** Your drag and drop order is used by the **Product grid** block on your homepage when its **Competition Sorting** option is set to **Manual Sort Order**. If it is set to **Ending Soonest at the top.**, the competitions closing first are shown first instead, and your manual order is ignored.

A few things to know:

* With **Manual Sort Order**, the **All** tab and each category tab follow your order.
* The **Today** tab or section (competitions ending today) always follows your manual order, whichever sorting option you pick, unless the block uses the **Custom Twig (Advanced)** card style.
* If the block's **Segmenting Competitions** option is set to **Calendar + Categories**, each category section lists the soonest ending competitions first, unless the block uses the **Custom Twig (Advanced)** card style.
* Custom Twig blocks can also use this order. See [Custom Twig Block](https://docs.rafflex.io/advanced/twig-templating/custom-twig-block.md).

To change the sorting option, see [Set Up Your Homepage](https://docs.rafflex.io/customise-your-site/set-up-your-homepage.md).
{% endhint %}

***

### Send a marketing email about several competitions

If you use Just Notify for email marketing, you can feature competitions in an email straight from this list.

1. Tick the box next to each competition you want to include.
2. Click the **Bulk actions** button that appears above the list.
3. Choose **justNotify.io Email Send**.
4. Fill in the **Title** and **Subject** (and, if you like, a **Coupon** and **Subtitle**), then click **Submit**.

This option only appears once Just Notify is set up as your email marketing provider. Competitions that are scheduled to open later cannot be included, so the email is not sent if you tick one. Remove it, or wait until it goes live. For the full steps, see [Sending an Email with Notify](https://docs.rafflex.io/marketing/sms-and-email/sending-an-email-with-notify.md).

***

### The competition edit page

Click any competition in the list to open its edit page. From top to bottom, you will find:

1. **Buttons** across the top right for previewing, instant wins, emails and more actions.
2. **Stats cards** showing how the competition is performing. On a [Prize Choice](https://docs.rafflex.io/create-your-first-raffle/prize-choice.md) competition where customers rank the prizes, a **What people are choosing** panel also appears here.
3. **The competition form** with all its settings (covered in [Create a Competition](https://docs.rafflex.io/create-your-first-raffle/create-a-competition.md)).
4. **Tabs** at the bottom for tickets, instant wins, winners and system logs.

After changing anything in the form, click **Save changes** at the bottom of the form.

{% hint style="warning" %}
**Renaming a live competition changes its link.** When you change the **Title** and save, the competition's web address (its **Slug**) is updated to match, unless you also typed your own slug. Any links you have already shared to the old address will stop working. Check the **Shareable competition link** card near the top of the form after saving, and share the new link if it has changed.
{% endhint %}

***

### Buttons at the top of the edit page

**View** or **Preview**

Opens the competition page on your live site in the same tab. The button says **View** when the competition is Active and **Preview** when it is not. Because you are logged in as an admin, you can preview a competition before it is switched on, even though customers cannot see it yet.

**Instant Wins**

Takes you to the page for adding instant win prizes to this competition. See [Add Instant Wins](https://docs.rafflex.io/create-your-first-raffle/add-instant-wins.md).

**Send Email**

Sends a quick marketing email about this competition to your Just Notify subscribers. It only appears when Just Notify is set up as your email marketing provider. Fill in the details in the pop up and click **Send Email**. The email goes to all your subscribers straight away, so double check it first. Scheduled competitions cannot be emailed until they open. See [Sending an Email with Notify](https://docs.rafflex.io/marketing/sms-and-email/sending-an-email-with-notify.md).

**Actions**

Click **Actions** to open a menu of extra tools:

* **Duplicate** makes a fresh copy of this competition, with the option to copy its instant wins too. See [Duplicate a Competition](https://docs.rafflex.io/create-your-first-raffle/managing-competitions/duplicate-a-competition.md).
* **Free Entry** adds tickets for a customer who has entered by post or another free route. The customer must already have an account on your site, and they receive the usual order confirmation email with their ticket numbers. See [Free Entry](https://docs.rafflex.io/additional-settings/free-entry.md).
* **Export csv** downloads a spreadsheet of every completed entry (see below).
* **Add Winners** lets you record the winning ticket numbers yourself. Each winner is sent a winner email. See [Manual Draw](https://docs.rafflex.io/drawing-winners/manual-draw.md).

{% hint style="info" %}
Want to copy a competition? The **Duplicate** option saves you rebuilding a similar competition from scratch. Read [Duplicate a Competition](https://docs.rafflex.io/create-your-first-raffle/managing-competitions/duplicate-a-competition.md) to see exactly what is copied and what you need to update before you switch the copy on.
{% endhint %}

#### Export csv

**Export csv** downloads a CSV file (a simple spreadsheet you can open in Excel, Numbers or Google Sheets) named after the competition. It lists every completed ticket in ticket number order, with three columns:

* **Display Name**, the name the customer shows publicly on your site.
* **Full Name**, the customer's first and last name.
* **Ticket Number**.

Only completed tickets are included (paid entries and any free entries you have added), so tickets still sitting in an unpaid basket are left out. This is handy for running a draw with an outside random number generator, or for keeping your own records.

{% hint style="info" %}
On very large competitions, **Export csv** may be unavailable and shows greyed out. If you need an entry list for a very large competition, contact Rafflex support.
{% endhint %}

{% hint style="warning" %}
The export contains your customers' names. Store it securely and only share it with people who need it.
{% endhint %}

***

### Stats cards

Four cards at the top of the edit page give you a quick health check of the competition:

| Card             | What it shows                                                                                                                                                                                                                                                          |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Revenue**      | The total taken from customer payments for this competition, after site credit and coupon discounts. Underneath, it shows how much was taken today ("in sales today").                                                                                                 |
| **Credit Used**  | How much [site credit](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals/site-credit-and-wallets.md) customers spent on this competition, including orders paid partly with credit ("Wallet & Partial Credit Used.").                                 |
| **Coupons Used** | The total value of [coupon discounts](https://docs.rafflex.io/marketing/website-tools/promos-and-discounts.md) applied to this competition. When an order includes several competitions, the discount is shared across them ("Order Coupon discount. Item weighted."). |
| **Tickets Sold** | How many tickets have been sold, with the number of tickets remaining underneath.                                                                                                                                                                                      |

Staff members with the **Restrict Financials** restriction do not see these cards. See [Staff Accounts and Access](https://docs.rafflex.io/managing-your-site/customers/staff-accounts-and-access.md).

***

### Tabs at the bottom of the edit page

Scroll below the competition form to find a set of tabs. Click a tab to switch between them.

{% tabs %}
{% tab title="Tickets" %}
Every ticket allocated in this competition, showing the customer's **Name**, the **Ticket number**, the **Order id** and when the ticket was created.

* Use the search boxes on the **Ticket number** and **Order id** columns to find a specific ticket or order.
* Click a ticket to open the order it belongs to.

{% hint style="danger" %}
**Deleting a ticket is permanent.** The **Delete** button (and **Delete selected** for several tickets at once) removes the ticket for good. It cannot be restored, and it does not refund the customer or tell them. Only delete tickets if you are completely sure, for example to tidy up after a test.
{% endhint %}
{% endtab %}

{% tab title="Instant Wins" %}
The instant win prizes set up on this competition. For each prize you can see how many winning tickets it has (**Tickets**), how many have been won so far (**Won**), whether it pays out as site credit (**Credit**), any **Payout** amount and any **Winlink** competition.

* Click **Create Instant Wins** to add more prizes. See [Add Instant Wins](https://docs.rafflex.io/create-your-first-raffle/add-instant-wins.md).
* Click **Edit** to change a prize, or **Delete** to remove it.
* Drag prizes up or down to change their order in the list.
  {% endtab %}

{% tab title="Winners" %}
This tab, headed **Draw Winners**, lists the main draw winners for this competition, with their name, winning ticket number, prize and when the winner was recorded.

Winners appear here after a draw, whether it ran automatically or you added them with **Actions**, then **Add Winners**. See [Manual Draw](https://docs.rafflex.io/drawing-winners/manual-draw.md).

You can remove a winner with **Delete** if one was added by mistake.

On a [Prize Choice](https://docs.rafflex.io/create-your-first-raffle/prize-choice.md) competition this tab also shows the **Delivery address** and **Prize Choice** columns, with **Choose prize**, **Pay prize** or **Reverse prize** on each row where needed. **Delete** is hidden on a paid cash or site credit prize until you reverse it. See [Managing Draw Winners](https://docs.rafflex.io/drawing-winners/managing-draw-winners.md#prize-choice-winners).
{% endtab %}

{% tab title="Instant Winners" %}
Every customer who has won an instant win prize in this competition, with their name, ticket number, prize, when they won (**Won At**) and a **Paid** or **Unpaid** badge. Paid winners are shown in green.

* **Mark paid** marks a prize as paid once you have sent it. If **Enable Payout Confirmation Email** is switched on (in **Settings**, then **Email**), the winner is emailed to let them know.
* **Mark UN-Paid** undoes this if you marked a prize by mistake.
* **View order** and **View user** open the winning order or the customer's account.

See [Managing Instant Winners](https://docs.rafflex.io/drawing-winners/managing-instant-winners.md), and [Which actions email the winner](https://docs.rafflex.io/drawing-winners/managing-payouts/which-actions-email-the-winner.md) for exactly when winners are emailed.
{% endtab %}

{% tab title="Leaderboard Winners" %}
This tab only appears if leaderboards are available on your site. It lists leaderboard prize winners for this competition, with the period, their rank, points, prize and whether the prize has been paid. You can mark winners as paid or unpaid here.

See [Leaderboards](https://docs.rafflex.io/additional-settings/leaderboards.md) for how leaderboards work.
{% endtab %}

{% tab title="System Logs" %}
A history of important changes and events on this competition, newest first. Each entry shows when it happened, the type of action, a short description, and who did it (the admin's email address, or "system" for automatic events).

Logs are recorded for things like the competition being created or updated, instant wins being added or removed, free entries being added, winners being added or drawn, and the competition being duplicated. On a Prize Choice competition, they also record each change customers make to their prize choice.

Click **View** on any entry to open the **Log Details**. When settings were changed, a **Changes** section lists each field that changed, with its **Before** and **After** value side by side. This is a great way to answer "who changed the end date?" or "what was the price before?".
{% endtab %}
{% endtabs %}

***

### Keep an eye on competitions ending soon

Your admin **Dashboard** includes a **Competitions Ending in the next 5 days** table. It groups your Active competitions by their end time, shows how many tickets each has sold, and gives you quick **Edit** and **View** buttons. It is a handy daily check to make sure nothing closes without you noticing. See [Dashboard](https://docs.rafflex.io/managing-your-site/dashboard.md).

***

### Related pages

{% content-ref url="/pages/rwVEXhq1XlXV2IEw8J1J" %}
[Create a Competition](https://docs.rafflex.io/create-your-first-raffle/create-a-competition.md)
{% endcontent-ref %}

{% content-ref url="/pages/IXLUhF41hDryMUwP9PRV" %}
[Duplicate a Competition](https://docs.rafflex.io/create-your-first-raffle/managing-competitions/duplicate-a-competition.md)
{% endcontent-ref %}

{% content-ref url="/pages/ikquN3GTGeJqpqnJdhcv" %}
[Hidden VIP Competitions](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/hidden-vip-competitions.md)
{% endcontent-ref %}

{% content-ref url="/pages/fyzFjnH0bvEkl5JgL3Nx" %}
[Product Categories](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/product-categories.md)
{% endcontent-ref %}
