> For the complete documentation index, see [llms.txt](https://help.openloyalty.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.openloyalty.io/main-features/leaderboards/sample-leaderboards.md).

# Sample Leaderboards

In this article we will show three different examples of leaderboards that can be used to engage your customers. 

[How-To Example: "Run monthly contests" Leaderboard](/main-features/leaderboards/sample-leaderboards.md#how-to-example-run-monthly-contests)

[How-To Example: "Top Referrer of the Month" Leaderboard](#how-to-example-top-referrer-of-the-month-leaderboard)

[How-To Example: "Promote a New Product" Leaderboard](/main-features/leaderboards/sample-leaderboards.md#how-to-example-promote-a-new-product-leaderboard)

### How-To Example: "Run monthly contests" Leaderboard

This is one of the most common and effective leaderboards you can create.

To set this up, you simply need to configure the leaderboard to track a specific wallet (e.g., your main "Points" wallet). This provides a simple and clear competition for your members.

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

### How-To Example: "Top Referrer of the Month" Leaderboard

To set this up, you will use a separate wallet that acts as a "counter".

Here is the step-by-step process:

**Step 1**: Create a "Tracking" Wallet First, create a new wallet specifically for this purpose. Let's call it the "Referral Count Wallet". The points in this wallet will only be used to keep score.

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

**Step 2**: Create a Referral Campaign Next, set up a referral campaign. The trigger for this campaign will be a successful referral (e.g., when the new member signs up or makes their first purchase).

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

**Step 3:** Configure the Campaign's Action Set the action of this campaign to award 1 point to the referrer. Crucially, you must set the destination wallet for this point to be your new "Referral Count Wallet". This means every time a member successfully refers someone, they get "+1" on their referral counter.

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

**Step 4:** Create the Leaderboard Finally, create your new leaderboard. Set its configuration to rank members based on the total points in the "Referral Count Wallet".

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

Now, your "Top Referrer" leaderboard will accurately display who has brought in the most new customers.

### How-To Example: "Promote a New Product" Leaderboard

This is an excellent strategy to drive sales for a specific item or category. This leaderboard will track *only* the points earned from a specific promotional activity.

As with the "Top Referrer" example, the solution is to create a separate "tracking" wallet to isolate these specific points.

Here is the step-by-step process:

**Step 1:** Create a "Tracking" Wallet First, create a new wallet that will only be used for this promotion. For example, let's call it the "New Product Promo Wallet".

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

**Step 2 & 3:** Create a Points Campaign Next, set up a new earning campaign. The Condition for this campaign will be: "*Quantity of products with a specific SKU\Quantity of products from a specific category*". Configure the Campaign's Action When configuring the campaign's action (to award points for the purchase), you must set the destination wallet to be your new "New Product Promo Wallet". This is the most important step, as it separates these promotional points from the member's regular point balance.

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

**Step 4:** Create the Leaderboard Finally, create your new leaderboard. Set its configuration to rank members based on the total points accumulated in the "New Product Promo Wallet".

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

This will create a leaderboard that shows exactly who is engaging most with your new product, allowing you to reward your top promoters.


---

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