# Raffles

### What are Raffles?

Raffles are special events that allow you to randomly select winners from a defined user group.&#x20;

Each raffle works as an independent draw based on eligibility conditions such as connected logins, completed quests or tasks, and accumulated points. It is used to form a list of users who participate in a draw. The system then automatically selects the winner(s) according to the configured logic.

Users do not see raffles in the app interface: participation happens automatically based on activity and eligibility.

### Configuration steps

1. In the header menu, go to **Extra** and select **Raffles**.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FHPwedqxnn9ACo4pHhHgJ%2FScreenshot%202025-10-08%20at%2021.05.11.png?alt=media&#x26;token=ee54da30-76a8-42b4-9f28-b102f8b0e341" alt=""><figcaption></figcaption></figure>

2. Click Create Raffle Button. This opens the raffle settings window.
3. Configure the following fields

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2Fq3jlui64JrDkY6XbxhQH%2FScreenshot%202025-10-08%20at%2021.08.27.png?alt=media&#x26;token=53c293df-3281-49a6-a862-ffa7d9bb7bc6" alt="" width="375"><figcaption></figcaption></figure>

**Raffle name**\
Enter the raffle name.

**Type**\
Select how the winner(s) will be determined.

* Hiscores – selects winners based on the highest number of points.
* Random – selects winners completely at random.
* Random based on points – selects winners randomly but with higher probability for users who have more points.

**Leaderboard**\
Select the leaderboard from which participants will be drawn.

* General campaign leaderboard – includes all users participating in the campaign.
* Tournament leaderboard – includes only users who are part of active tournaments.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FKaGCtjkIBye5SrhE61e3%2FScreenshot%202025-10-08%20at%2021.08.39.png?alt=media&#x26;token=57840e23-8930-4c64-9bf5-f723ab07f49e" alt="" width="375"><figcaption></figcaption></figure>

**Max participants**\
Define the maximum number of users allowed to qualify for the raffle. For example, if there are 20 eligible participants but the limit is set to 10, only the top 10 will qualify as winners.

**Min points**\
Set the minimum number of points required for a user to enter the raffle.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FCukCAlHCI1JW6brjFEbX%2FScreenshot%202025-10-08%20at%2021.08.48.png?alt=media&#x26;token=14bc61f9-02bb-45fb-b077-e4447c783349" alt="" width="375"><figcaption></figcaption></figure>

**Required logins**\
Select the connected platforms users must have to qualify for the raffle.\\

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2Fy2ecdJzd9Sz02YOxIU6d%2FScreenshot%202025-10-08%20at%2022.01.17.png?alt=media&#x26;token=4f2028fc-23a1-4596-b671-bb7a733c99a4" alt="" width="375"><figcaption></figcaption></figure>

**Required quests**\
Select the quests users must complete to become eligible.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FFtyzjRUEd5469Kw6eeko%2FScreenshot%202025-10-08%20at%2022.01.29.png?alt=media&#x26;token=14ce88e8-c171-4dcb-bf22-06fe4321eff1" alt="" width="375"><figcaption></figcaption></figure>

**Required tasks** \
Select the tasks users must complete to qualify. Tasks can be linked to quests or used independently.

When all fields are configured, click Create. The raffle will appear in the list of raffles.

#### Raffle status and management

Once the raffle is created, it appears as a card in your Raffles dashboard. \
On the raffle card, you can see:

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FKqWjhn5zcXRxX9YZsbhp%2FScreenshot%202025-10-08%20at%2021.09.11.png?alt=media&#x26;token=bf3da960-a259-451b-bc5d-882e311d0807" alt="" width="375"><figcaption></figcaption></figure>

* The raffle status
* The selected type and leaderboard
* The number of participants
* The required points threshold
* The required logins, quests, and tasks

**Raffles statuses**:

* Created - the raffle is configured but not yet finalized. Raffles remain in created status until they are closed.
* Closed (ended) - the raffle is completed, and results are available for review.

Once closed, the system compiles the participant list based on all configured conditions and determines the winners according to the selected Type.

Raffles can be managed using the available actions:

* End – close the raffle and generate the results.
* Edit – modify raffle settings.
* Delete – remove the raffle.
* Analytics – open participant details and winner information.

#### Analytics

From the raffle card, click the Analytics icon in the upper corner to view participant data.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FfR2AQsL3wP41Gxl9pjx1%2FScreenshot%202025-10-08%20at%2021.24.29.png?alt=media&#x26;token=ec58a7bd-e2f2-47f6-80e2-eb180bd4574f" alt="" width="563"><figcaption></figcaption></figure>

The leaderboard table displays:

* Position – participant ranking in the raffle.
* Status – allows you to manually disqualify or restore users.
* Name – participant name.
* Quests – completed quests (if applicable).
* Tasks – completed tasks (if applicable).
* Points – total points earned.

Users marked in gray are excluded from the export file and do not appear in the list of winners.

Click **Get leaderboard .csv** file to export the final participant data, including usernames, connected platforms, and point totals. Only qualified users (within the defined participant limit and meeting all requirements) are included in the exported file.

#### User view

Raffles are invisible to users in the app interface. Participation and winner selection are handled entirely in the admin panel. You can optionally use the exported data to announce winners or manage prize distribution externally.
