> ## Documentation Index
> Fetch the complete documentation index at: https://docs.claimr.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tournaments

> Configure tournament requirements and point types, manage tournament status, and review tournament analytics and the user-facing leaderboard tab.

## What are tournaments?

Tournaments are temporary events that you create and manage from the admin panel. Each tournament runs as a separate leaderboard session, independent of the standard leaderboard. This allows you to track user activity within a defined time frame. Only one tournament can be active at a time. All tournaments can be reviewed in the **Analytics** section.

## Configuration steps

In the header menu, go to **Extra** and select **Tournaments**. Click **+ Add Tournament**. This opens the tournament settings window.

<Frame>
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/extra/tournament-add-button.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=4d7a63d288416cf35f4c4c378b168ee0" alt="Add Tournament button" width="1570" height="504" data-path="images/extra/tournament-add-button.png" />
</Frame>

Configure the following fields:

<Frame>
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/extra/tournament-settings-fields.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=25e25a080b209e3b45d7d39c01061acd" alt="Tournament settings fields" width="866" height="1090" data-path="images/extra/tournament-settings-fields.png" />
</Frame>

* **Name**: enter the tournament name.
* **Required logins**: select the connected platforms that users must have to be eligible for the tournament leaderboard.
* **Required quests**: select the quests that users must complete to qualify.
* **Required tasks**: select the individual tasks that users must complete. Tasks can be linked to quests or used independently.
* **Points type**: if your campaign has multiple point types configured in Points settings (e.g., XP plus additional customizable points), select which point type will be used to calculate the tournament leaderboard.

<Frame>
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/extra/tournament-points-type-selection.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=6edb429389ee6af5e25b2ad93e569c74" alt="Tournament points type selection" width="854" height="190" data-path="images/extra/tournament-points-type-selection.png" />
</Frame>

When all settings are configured, click **Create**. The tournament will appear in the list of tournaments.

<Frame>
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/extra/tournament-list.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=cef31e20edab9712094900bcd6cc7ac0" alt="List of tournaments" width="956" height="504" data-path="images/extra/tournament-list.png" />
</Frame>

Manage the tournament using the available actions:

* Start — activate the tournament. A dedicated leaderboard will be created.
* End — finish the tournament. The leaderboard is closed and stored as historical data.
* Edit — change the tournament name.
* Delete — remove the tournament.

## Completion logic

<Frame>
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/extra/tournament-status-flow.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=6395982d2795e9a869a12059f5f5ea67" alt="Tournament status flow" width="978" height="1314" data-path="images/extra/tournament-status-flow.png" />
</Frame>

* Only one tournament can run at the same time.
* Created tournaments remain in status created until started.
* When started, the status changes to started and all user activity contributes to the tournament leaderboard.
* When ended, the status changes to ended and the final leaderboard is stored for analytics.

Once a tournament is started, you can access its analytics directly from the tournament card by clicking the Analytics icon in the upper corner next to the Edit button.

## Analytics

1. You can access tournament analytics in two ways:
   * In the header menu, go to Analytics and select Tournaments.
   * From the Tournaments view, click the analytics icon in the upper corner of a specific tournament card.
2. The overview table will open showing all tournaments with their name and status. Clicking a tournament opens its leaderboard.
3. The leaderboard is displayed as a dynamic table with the following columns:

   <Frame>
     <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/extra/tournament-analytics-leaderboard.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=ec7b5c440fac0024496c49ad18fb44df" alt="Tournament analytics leaderboard" width="2872" height="560" data-path="images/extra/tournament-analytics-leaderboard.png" />
   </Frame>

   * Name — username or identifier.
   * Points — total points earned.
   * Connected accounts — Twitter, wallet, Discord, or other linked accounts (columns appear dynamically depending on available data).
4. You can sort the table, copy wallet addresses, and export the leaderboard to a .csv file.
5. Clicking a user opens detailed information about that participant.

## User view

<Frame>
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/extra/tournament-user-view-leaderboard-tab.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=c4fae70a6bc6ebd7450c4f8bccb90051" alt="Tournament tab in the user-facing leaderboard" width="1066" height="282" data-path="images/extra/tournament-user-view-leaderboard-tab.png" />
</Frame>

* In the app leaderboard, a Tournament tab appears next to the Main leaderboard when a tournament is active.
* Users can switch between the main leaderboard and the tournament leaderboard to see rankings.
* Tournament leaderboards have the same structure and options as the main leaderboard.
