> 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/ranks.md).

# Ranks

## **Understanding ranks**

Ranks are a powerful gamification tool that allows you to create a tiered system of achievement within your campaigns. Users earn points by completing tasks and quests, and as they accumulate points, they progress through different ranks. Each rank can be associated with specific rewards, benefits, or recognition, providing a clear path for users to strive for and a sense of accomplishment as they advance.

### **Benefits of using ranks**

**Increased engagement:** Ranks provide a clear goal for users to work towards, encouraging them to participate more actively in your campaigns.

**Motivation and progression:** The tiered system motivates users to continue engaging with your campaign to reach higher ranks and unlock new rewards.

**Sense of accomplishment:** Achieving new ranks provides a sense of accomplishment and recognition, fostering a positive user experience.

**Community building:** Ranks can be used to create a sense of community and hierarchy within your campaign, encouraging users to compare their progress and strive for higher levels of achievement.

**Personalization:** Ranks can be customized to match your campaign's theme and branding, creating a more immersive and engaging experience for your users.

## **Configuring ranks**

1. **Access the Ranks section:** Navigate to the **Events** section in the claimr admin panel and select the **Ranks** tab.

<figure><img src="/files/XhmJ7DQG8HguWsQbrTK1" alt="" width="563"><figcaption><p>Rank pannel</p></figcaption></figure>

2. **Create a rank:** Click <mark style="color:green;">**Create Rank**</mark> button to add a new rank.
3. **Define rank details:**

<figure><img src="/files/S8vcj1d6CYasizLyVvtP" alt="" width="375"><figcaption><p>Rank settings</p></figcaption></figure>

* **Name:** Provide a clear and concise name for the rank (e.g., "Bronze," "Silver," "Gold").
* **Image:** Upload an image or icon that represents the rank.
* **Rank points:** Specify the number of points required to achieve this rank.
* **Points:** (Optional) Award bonus points to the user upon achieving this rank.
* **Rewards:** (Optional) Add additional rewards associated with this rank (e.g., NFTs, gift codes).

4. **Save the rank:** Click the "Create" button to save your new rank.

## **Presenting ranks to users**

<figure><img src="/files/IDzFqVZjKYPUj1Yx50Nf" alt="" width="318"><figcaption><p>Ranks widget</p></figcaption></figure>

**Rank display:** The user's current rank is clearly displayed within their profile or progress section. This typically includes the rank name or icon and the user's current points progress.

**Progress bar:** A progress bar visually represents the user's progress towards the next rank, showing how many points they need to earn to reach the next level.

## **How users Interact with ranks**

Users earn points by completing tasks and quests within your campaign. As they accumulate points, their rank automatically updates. Users can see their current rank and progress towards the next rank in their profile or progress section.


---

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