> 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/additional-settings/settings/entry-list-display.md).

# Entry List Display

Show everyone the confirmed tickets in a competition, with ticket numbers, entrant names and entry dates. Learn how to switch entry lists on, choose how names appear, limit who can view them, and what

***

An entry list is a public, live table of every confirmed ticket in a competition. It shows each ticket number, who owns it and when it was bought. Entry lists are one of the simplest ways to show [transparency](https://docs.rafflex.io/standards/standards/transparency.md) to your players: anyone can check that tickets were really sold, and customers can find their own tickets in seconds.

You control entry lists in four places:

| What                                             | Where                                  | What it does                                                         |
| ------------------------------------------------ | -------------------------------------- | -------------------------------------------------------------------- |
| **Entry list** toggle                            | On each competition                    | Switches the entry list on or off for that competition               |
| **Product Entry List**                           | **Settings**, then **Product**         | Also shows the entry list at the bottom of each competition page     |
| **Entry List Name Display**                      | **Settings**, then **User Experience** | Chooses how entrants' names appear in every entry list               |
| **Disable Entry List Unless In The Competition** | **Settings**, then **Advanced**        | Limits entry lists to customers who have tickets in that competition |

***

### Switch on the entry list for a competition

Entry lists are switched on one competition at a time.

1. In the **admin panel**, find the **Competitions** group in the left-hand menu and click **Competitions**.
2. Click the competition you want to update (or click **New Competition** to create one).
3. Scroll down past the main details to the block of toggles (**Add To Slider**, **Entry list**, **Upsell**, **Auto draw** and **Active**).
4. Switch on **Entry list**.
5. Click **Save changes** (or **Create** if it is a new competition).

The competition now appears on your public **Entry Lists** page, and its own entry list can be opened from there.

{% hint style="info" %}
**The competition must also be live.** An entry list only opens while the competition's **Active** toggle is on. If **Active** is off, anyone trying to view its entry list is sent to your homepage instead.
{% endhint %}

{% hint style="info" %}
A [scheduled competition](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/schedule-a-competition.md) does not show an entry list until its start date arrives, even with **Entry list** switched on. Until then it is left off your Entry Lists page, and anyone trying to open its entry list is sent to your homepage. Once it opens, the entry list appears automatically.
{% endhint %}

{% hint style="success" %}
**Tip:** when you [duplicate a competition](https://docs.rafflex.io/create-your-first-raffle/managing-competitions/duplicate-a-competition.md), its **Entry list** setting is copied too, so you only need to switch it on once for a series of competitions.
{% endhint %}

***

### Show the entry list on competition pages

By default the entry list lives on its own page. You can also show it at the bottom of each competition's page, so customers see it without leaving the competition.

{% hint style="info" %}
**Cannot see Product Entry List?** Showing the entry list on competition pages is switched on or off for your site by RaffleX. Contact RaffleX support and ask for it. Without it, competition pages and Results cards do not link to that competition's entry list, so customers find it from the **Entry Lists** page instead.
{% endhint %}

1. In the **admin panel**, find the **Content** group in the left-hand menu and click **Settings**.
2. In the Settings side menu, click **Product**.
3. Switch on **Product Entry List**.
4. Click **Save Settings**.

{% hint style="info" %}
Only competitions with **Entry list** switched on show it, and only once the competition has started. Ended competitions keep showing their final list.
{% endhint %}

***

### Choose how names appear

**Entry List Name Display** controls how entrants' names appear in the **Customer** column of every entry list on your site. Whatever you choose is shown to everyone who views the list.

| Option                         | What visitors see                                              | Example     |
| ------------------------------ | -------------------------------------------------------------- | ----------- |
| **First Name + Last Initial**  | The entrant's first name and the first letter of their surname | Joe B       |
| **Full Name**                  | The entrant's first name and surname                           | Joe Bloggs  |
| **Display Name** (the default) | The display name on the customer's account                     | Joebloggs88 |

{% hint style="warning" %}
**Think about privacy.** Entry lists can be seen by anyone, so **First Name + Last Initial** is a good balance between transparency and protecting your customers. Only choose **Full Name** if your customers expect it and your terms and privacy policy cover it.

When a customer registers, their display name usually starts as the first part of their email address (the bit before the @). Customers can change it from **My Account** on your site.
{% endhint %}

To change it:

1. In the **admin panel**, find the **Content** group in the left-hand menu and click **Settings**.
2. In the Settings side menu, click **User Experience**.
3. In the **Profile Settings** section, choose an option from **Entry List Name Display**.
4. Click **Save Settings**.

If a customer's account has been deleted, their tickets stay in the list and the **Customer** column shows **User Deleted.**

Names in the **Customer** column always start with a capital letter, whichever option you choose. If the names in your entry lists do not match the option you picked, contact Rafflex support.

{% hint style="info" %}
Winner names are controlled separately, by **Winners Name Display** on the same page. See [User Experience Settings](https://docs.rafflex.io/additional-settings/settings/user-experience-settings.md).
{% endhint %}

***

### Only show entry lists to people in the competition

If you would rather not show entry lists to the whole world, switch on **Disable Entry List Unless In The Competition**. The helper text reads "If enabled, users will only be able to see the entry list for a competition if they have purchased tickets for that competition."

1. In the **admin panel**, find the **Content** group in the left-hand menu and click **Settings**.
2. In the Settings side menu, click **Advanced**. The page title reads **Advanced & Configuration**.
3. In the **Entry Settings** section, switch on **Disable Entry List Unless In The Competition**.
4. Click **Save Settings**.

With this switched on:

* Customers who are **logged in** and have tickets in a competition can see its entry list as normal.
* Everyone else (visitors who are not logged in, and customers without tickets in that competition) sees the heading and the message "To view our full entry list you first have to be a part of this competition.", with a button to go to the competition page.
* **Admins can always see every entry list**, so you can check them at any time while logged in to your admin account.
* Your public **Entry Lists** page still shows every competition with its entry list switched on. The setting only controls who can open the list itself.

The setting applies to every competition on your site. See [Advanced Settings](https://docs.rafflex.io/additional-settings/settings/advanced-settings.md) for the rest of that page.

***

### What customers see

#### The Entry Lists page

Your site's main menu always includes an **Entry Lists** link (in the header on desktop, and in the side menu on mobile), even when no competitions currently have an entry list switched on. It opens a page headed **Ticket Lists**, with the line "Transparent Realtime ticket lists that keep everyone updated and in the loop."

The page shows a grid of cards, 16 per page. Each card shows the competition's image, title, **Price** and **Ends** date. Clicking a card opens that competition's entry list. Competitions are shown with the latest end date first.

A competition appears on this page when:

* Its **Entry list** toggle is on.
* Its **Active** toggle is on.
* It has started (scheduled competitions appear once their start date arrives).
* It is **not** a [Hidden VIP Competition](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/hidden-vip-competitions.md).

Ended competitions stay on the page for as long as they are still switched to **Active**, so customers can keep checking past entries. If no competitions qualify, the page shows "No Competitions Found, simplify your search and try again."

{% hint style="info" %}
**Using a custom header?** The **Entry Lists** link is part of the standard header and side menu. If your site uses a custom designed header and the link is missing, contact Rafflex support. For developers, the link is available as the `urls.entry_lists` variable in [Header and Footer Variables](https://docs.rafflex.io/advanced/twig-templating/header-and-footer-variables.md).
{% endhint %}

{% hint style="info" %}
A hidden VIP competition is left off the Entry Lists page, but its entry list still opens for anyone who already has a direct link to it.
{% endhint %}

#### A competition's entry list

Each entry list opens with the heading **"Competition name" Ticket List** and the line "Search & View all of the confirmed tickets for this competition!"

**The competition summary.** At the top is a summary card with the competition's image, title, any categories, a **Winners** badge if there is more than one winner, the **Price**, the **Cash Alternative** (if set), **Max Tickets** and the **Ends** date. A progress bar shows how many tickets have sold and the percentage sold. A **View** button takes customers back to the competition page.

**Search and filters.**

* **Search ticket number.** Type a ticket number to jump straight to it. Only numbers can be typed.
* **Per page.** Choose **10 per page**, **20 per page** or **50 per page**.
* **Show My Tickets.** Logged in customers see a **Show My Tickets** button with their ticket count, for example **Show My Tickets (12)**. Clicking it shows only their own tickets. Visitors who are not logged in see a greyed out **My Tickets** button.

**The table.** Tickets are listed in ticket number order, with these columns:

| Column       | What it shows                                                                                                  |
| ------------ | -------------------------------------------------------------------------------------------------------------- |
| **Ticket #** | The ticket number. A customer's own tickets are highlighted and marked **You**.                                |
| **Status**   | **Confirmed**, with a tick. Only paid, confirmed tickets are listed.                                           |
| **Customer** | The entrant's name, shown the way you chose in **Entry List Name Display**.                                    |
| **Date**     | When the ticket was bought, for example "Mar 14, 7:32 PM". The year is added for tickets from a previous year. |

Underneath, **Total Tickets** shows how many tickets have been sold in the competition (or **Your Tickets** when **Show My Tickets** is on). Customers move through the list with the **Prev** and **Next** buttons, and jump to the first or last page with the double arrow buttons.

{% hint style="info" %}
**Why is a customer's ticket not showing yet?** The entry list only shows tickets once the order is paid and confirmed. Tickets in an order that is still being paid for are not listed. New tickets can also take a couple of minutes to appear on the first page of the list, so ask the customer to check again shortly. See [Pending Tickets](https://docs.rafflex.io/managing-your-site/orders/pending-tickets.md) for how unpaid orders work.
{% endhint %}

***

### Extra tools for admins

When you view an entry list while logged in to your admin account, you get a few extra tools:

* **An Admin column.** Each row has a **User** button that opens that customer's account in your admin panel. See [Customers](https://docs.rafflex.io/managing-your-site/customers.md).
* **Access to every list**, even with **Disable Entry List Unless In The Competition** switched on.
* **A Draw Winners button.** If TrueNorth is connected and **Provably Fair Autodraws** is switched on, a **Draw Winners** button appears on the competition summary card. Use it to run a live draw once the competition has ended. See [TrueNorth Live Stream Draws](https://docs.rafflex.io/drawing-winners/truenorth-setup/truenorth-live-stream-draws.md) for when the draw can run.

***

### Related pages

* [Create a Competition](https://docs.rafflex.io/create-your-first-raffle/create-a-competition.md)
* [User Experience Settings](https://docs.rafflex.io/additional-settings/settings/user-experience-settings.md)
* [Advanced Settings](https://docs.rafflex.io/additional-settings/settings/advanced-settings.md)
* [Hidden VIP Competitions](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/hidden-vip-competitions.md)
* [Transparency](https://docs.rafflex.io/standards/standards/transparency.md)
