> For the complete documentation index, see [llms.txt](https://docs.claimr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.claimr.io/extra/tournaments.md).

# Tournaments

## 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.

<figure><img src="/files/KAz0MFv3P3n6EgPprIb4" alt="" width="375"><figcaption></figcaption></figure>

\
Configure the following fields

<figure><img src="/files/yWPiBtuC2L3Q3pxba6cf" alt="" width="375"><figcaption></figcaption></figure>

* **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.<br>

<figure><img src="/files/j9lA6fzawQJjjLWf4RpD" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="/files/L9aYM8USygrKNHICb2zx" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="/files/EdOFgWNV1gscS1QDJB4m" alt="" width="375"><figcaption></figcaption></figure>

* 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:

   <figure><img src="/files/W0oiPZV1skMSE5P36cqI" alt=""><figcaption></figcaption></figure>

   * 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

<figure><img src="/files/YwqdzVVxCN8MP0SzJq1E" alt="" width="375"><figcaption></figcaption></figure>

* 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.claimr.io/extra/tournaments.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.