---
title: "Use Case: Weekly Rotating Leaderboard"
slug: "use-case-weekly-rotating-leaderboard"
updated: 2026-07-16T09:58:30Z
published: 2026-07-16T09:58:30Z
canonical: "docs.xtremepush.com/use-case-weekly-rotating-leaderboard"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Case: Weekly Rotating Leaderboard

You want a summer leaderboard that runs from **July to Septembe**r, ranking users by how many bets they place. Users earn a point for **each bet of €20 or more**, and the leaderboard refreshes every week. This leaderboard is open to all users. You want to reward the **top 10 bettors** each week with tokens, and also want to give a non-token reward to positions 11 to 15.

The configuration for this example is as follows:

## Leaderboard Score

Here, you configure the leaderboard's score to rank users by how many bets they place between July and September.

- **Progress Counter**: Set to **+1 with every event**.
- **Desired Action**: Set to `BetExecuted`, with a requirement that `$.body.amount.value ≥ 20`. These are example event and property namea.

Each bet adds 1 to a user's score.
- **Start At** and **End At**: Set to 1 July and 15 September, to ensure the leaderboard remains active only during this period.

## Tiering and Participation

Leave both sections empty, since this leaderboard is open to all users.

## Rewards

Set the **Rotation Period** to **1 week**, so rewards are given out every week. Since rewards are given out often, keep the token amounts low.

Set the reward configuration as follows:

| From position | To position | Reward |
| --- | --- | --- |
| 1 | 1 | 50 tokens |
| 2 | 2 | 40 tokens |
| 3 | 3 | 30 tokens |
| 4 | 5 | 15 tokens |
| 6 | 10 | 10 tokens |
| 11 | 15 | 5 free spins (external reward from your promotions engine) |

## Presentation

Configure how this leaderboard appears to users in the widget, including messaging for users who aren't yet eligible to take part.

- **Title**: Weekly Summer Bets
- **Description**: Place bets of €20 or more to climb the leaderboard. Rewards are given out every week throughout the summer.
- **Blocked description**: Leave this empty, since there are no participation requirements for this leaderboard.
- **Score label**: Qualifying Bets