# Leaderboards

Leaderboards in Open Loyalty are dynamic ranking systems designed to display your members in order of their performance based on a specific metric. 

<figure><img src="https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FisRq037VpuIcM73RioNQ%2Fimage.png?alt=media&#x26;token=1341c162-51bb-443c-8371-ffb59851c377" alt=""><figcaption></figcaption></figure>

By showcasing how members compare to each other, leaderboards can motivate participants to achieve higher scores or more activity.&#x20;

{% hint style="info" %}

* **Currently, you can have up to 3 active leaderboards within an environment.**
* Members with the same tracked metric value will tie and appear in the same position on the leaderboard.
* Leaderboards are recalculated **every 4 hours.**
* Future updates will expand leaderboard capabilities, including the ability to target specific segments or tiers and introduce additional conditions.
  {% endhint %}

***

### How leaderboards drive engagement

Leaderboards add an exciting, competitive element to your loyalty program. They are effective because they:

* **Spark Healthy Competition**: Members will strive to earn more points to see their name at the top of the list.
* **Encourage Specific Actions**: They create a clear incentive for members to repeat profitable behaviors to climb the rankings.
* **Reward Top Members**: They give you a simple and public way to identify and reward your most active and valuable customers.
* **Build Community**: A shared contest or ranking creates a sense of community and friendly rivalry.

### What you can do with leaderboards (common use cases)

Leaderboards are flexible and can be used to achieve many different goals. For example, you can:

* **Run Monthly Contests**: Create a short-term leaderboard for the "Top 10 Point Earners of the Month" and offer a bonus prize to the winners. This creates urgency and repeat visits.
* **Incentivize Referrals**: Run a month-long "Top Referrer" leaderboard to see which of your members are bringing in the most new customers and reward them accordingly.
* **Promote New Products**: Launch a leaderboard that tracks points earned *only* from the purchase of a new product or category.

## Learn more about

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Creating Leaderboards</strong></td><td>Find out how to create your first leaderboard.</td><td><a href="leaderboards/creating-leaderboards">creating-leaderboards</a></td></tr><tr><td><strong>Managing and Viewing Rankings</strong></td><td>Check how to manage leaderboards and view global rankings.</td><td><a href="leaderboards/managing-and-viewing-rankings">managing-and-viewing-rankings</a></td></tr><tr><td><strong>Rewarding Cycle</strong></td><td>Check how to reward members based on how they perfrom in a leaderboard.</td><td><a href="leaderboards/rewarding-cycle">rewarding-cycle</a></td></tr><tr><td><strong>Single Member Ranking</strong></td><td>Check how to view rankings for a single member.</td><td><a href="leaderboards/single-member-ranking">single-member-ranking</a></td></tr><tr><td><strong>Common use cases</strong></td><td>Check our examples on leaderboards.</td><td><a href="leaderboards/sample-leaderboards">sample-leaderboards</a></td></tr></tbody></table>


---

# 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://help.openloyalty.io/main-features/leaderboards.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.