> For the complete documentation index, see [llms.txt](https://docs.terragon.io/documents/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.terragon.io/documents/terragon-manual/tournaments-module.md).
# Tournaments Module
## **Introduction**
The **Tournaments** module is a dynamic and engaging promotional tool designed to increase user retention, boost activity, and encourage friendly competition among players. This feature allows operators to create time-limited competitive campaigns where players can participate by meeting specific gameplay criteria—such as highest win amount, total turnover, or other selected metrics.
Tournaments can be customized based on game segments, VIP levels, user segments, and reward structures, offering both flexibility and strategic targeting. Operators have full control over eligibility, mechanics, and prize distribution, enabling the creation of personalized experiences that align with brand goals and user behavior.
Whether you're looking to promote a new game, incentivize high-value players, or simply enhance the entertainment value of your platform, the Tournaments module provides a powerful framework to run recurring or one-time events with automated reward handling.
## **1. Tournament List**
Upon entering the **Tournaments** module, users are directed to the Tournament List page. It includes the following sections:
**Search Filters:**
* **Created Date Period** – Select a specific timeframe.
* **Tournament Code** – Filter by unique tournament identifier.
* **Tournament Name** – Filter by tournament title.
* **Status** – Dropdown to filter based on current status: e.g., Completed, Draft, Active, etc.
**Tournament Table:**
Displays all configured tournaments with the following columns:
* **ID**
* **Name**
* **Code**
* **Status** (e.g., Completed, Draft)
* **Start Date / End Date**
* **Created By / Updated By**
* **Actions** – Show, Update, Duplicate
## **2. Create New Tournament**
Opens the 3-step tournament creation form.
### 2.1 Step 1: General
**General Information Fields:**
* **Code** *(required)* – Unique internal identifier.
* **Name** *(required)* – Tournament title.
* **Game Segment** – Filter participants based on specific game types.
* **Recurrence Settle Period** – Choose between:
* None
* Daily
* Weekly
* Monthly
* **Start / End Date** *(required)* – Define the active time window.
* **Description** *(required)* – Description of the tournament's rules and structure.
#### Mechanic - Defines how the winners are calculated. Available options:
* **Win Amount**
* **Turnover**
* **Multiplier**
* **Total Round**
*Only one mechanic can be selected per tournament.*
### 2.2 Step 2: Eligibility
Specify user eligibility conditions:
**Fields:**
* **Minimum Wager** – Only players with bets above this value can participate.
* **VIP Levels** – Select one or multiple levels.
* **Segments** – Target specific user segments using:
* In Any
* In All
* Not In
* **Only Show for Eligible Player** – Checkbox to restrict tournament visibility.
### 2.3 Step 3: Rewards
**Reward Configuration:**
* **Automate Rewards Settlement** – Toggle to auto-process results.
* **Reward Type**:
* Cash Rewards
* Bonus Rewards
* **Prize Pool**– Define the total amount and currency.
* **Prize Distribution** – Add tiers with:
* From, To, and Prize fields.
* Option to **Distribute the rest** automatically across remaining tiers.
Once the configuration is complete, click **Submit** to launch the tournament.