# Leaderboard

The Leaderboard feature allows users to view their standing in a points-earning activity within the platform. It is divided into two distinct tabs: "General" and "Friends," providing both a competitive and social aspect to the user experience.

### Feature Description <a href="#feature-description" id="feature-description"></a>

To install the Leaderboard feature, go to the corresponding section in the Admin Panel, select the Leaderboard card, and click Install.

<figure><img src="/files/KiSicNX9ydWvmGzyCAxT" alt="My Widget section, Leaderboard card"><figcaption><p>My Widget section, Leaderboard card</p></figcaption></figure>

After installing the feature, in the Missions tab on the widget, a Leaderboard banner will appear displaying the user’s current position in the general leaderboard.

<figure><img src="/files/kCVIKOuBYtmpf7Q8oFN8" alt="Leaderboard banner"><figcaption><p>Leaderboard banner</p></figcaption></figure>

> The Leaderboard banner will be displayed for users who have earned at least 1 point.

When clicking on the banner, the user will be redirected to the Leaderboard section.\
The user can also navigate to the Leaderboard section by clicking on the kebab menu in the header and selecting Leaderboard.

<figure><img src="/files/VXFHbSJ9y79WVecvODse" alt="Leaderboard section in kebab menu"><figcaption><p>Leaderboard section in kebab menu</p></figcaption></figure>

The **Leaderboard section**&#x20;

* **General** tab
* **Friends** tab

### General Tab <a href="#general-tab" id="general-tab"></a>

When opening the Leaderboard section, the General tab is selected by default.

<figure><img src="/files/VfftDvkVuBkr3Eol8p8f" alt="General tab in Leaderboard Section"><figcaption><p>General tab in Leaderboard Section</p></figcaption></figure>

The General tab displays the following data:

* **Total Users** block, showing the total number of users in the leaderboard who have earned at least 1 point.
* A **list of the top 100 users** by earned points, and below that — the current user’s position.
* Statistics of **earned loyalty points** and the user's **position** on the leaderboard among the entire user base.
* **Current username** of the user and other participants on the platform.

**Transaction Types Counted in the Leaderboard**

To determine a user’s place on the leaderboard and calculate the total number of points earned by the user, we use a formula that takes into account and sums the number of points earned for the following activities:

* +Missions Earn (any type of missions)
* +Quest
* +Tap to Earn reward
* +Hold to Earn reward
* +Referral Reward
* +Manual In
* -Manual Out

{% hint style="info" %}
If the user spends their points on redeeming a reward, purchasing a tier, or withdrawing them to an external wallet (in the Web3 case), their position on the leaderboard does not decrease, since **the leaderboard is based on the total amount of points earned by the user, not their balance.**
{% endhint %}

### Friends Tab <a href="#friends-tab" id="friends-tab"></a>

When navigating to the Friends tab, the user will see the following data:

* **Total Users** block, displaying the number of valid invited referrals.
* A **list of referrals** the user has invited to the platform, as well as their position among referrals based on the total amount of points earned.
* The **total amount of points earned by the referrals** they have invited to the platform.
* The user's username, as well as the referral usernames.

<figure><img src="/files/GVEIHilcDBfZuDMqW2gj" alt="Friends tab in Leaderboard section"><figcaption><p>Friends tab in Leaderboard section</p></figcaption></figure>

> * Only valid referrals will be displayed in the list — those **who have completed the condition set in the referral program**.
> * If no condition was set, then all users who entered the **invitation referral code** will be displayed.

In case of Referral Reward Type: Ref Share, in Friends tab will be displayed only direct referrals (Tier 1).

**If the user hasn’t invited any referrals**:

* The Total Users block will show 1, counting only the current user.
* The **Friends** tab will display an **Invite Friends** button. Clicking it will redirect the user to the **Referral** section.

<figure><img src="/files/uTT6k8bbAg231QhcoW6Z" alt="Invite Friends button on Friends tab"><figcaption><p>Invite Friends button on Friends tab</p></figcaption></figure>

{% hint style="info" %}

* The calculation of earned points by users starts from the moment the feature is enabled.
* **Leaderboard data is refreshed once per 10 minutes.**
* If the feature is disabled and then enabled again, the system will remember the number of points earned by users before it was turned off, and after enabling it again, continue counting from the amount recorded before the feature was disabled.
* All points earned by users while feature is disabled will not be counted in the Leaderboard.
* A user who was blocked in the admin panel will not be displayed in the leaderboard.
* At the moment, there is **no self-serve option to reset the Leaderboard** to start a new competitive season directly from the Admin Panel. Don't hesitate to **get in touch with the Enable3 representative to reset it** on your behalf.
  {% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.enable3.io/enable3/leaderboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.