# Rewarding Cycle

The **Rewarding Cycle** is an additional step in the leaderboard setup that allows you to automatically reward members based on their **final ranking positions**. Rewards are distributed at the end of each monthly cycle.

***

## 📌 How It Works

* Rewards are always issued **monthly**, at the **end of the month**.
* If a leaderboard **spans across months** (e.g. *15 Sep – 15 Oct*), rewards will be issued **twice**:
  * On **1 Oct** (start of the new cycle).
  * On **15 Oct** (end of leaderboard).
* If a leaderboard **starts and ends within the same month**, members will only be rewarded **once**, at the end of the leaderboard.
* If a leaderboard has **no end date**, rewards are distributed **every month** at the end of the cycle.

{% hint style="danger" %}
After the end of the month, the system waits **1 hour** for all events to flow in (e.g., points for the previous month’s activity).

Rewards may take up to **2 hours** to be fully calculated and issued.
{% endhint %}

***

## Step-by-step instructions

Follow these steps to add a rewarding cycle:

{% stepper %}
{% step %}
**Enable Rewarding Cycle**

Check the box during the final step of leaderboard setup.

<figure><img src="/files/tNyuRuYBW8Jimf7q6bvO" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Define Reward Logic**

* Define conditions:
  * **Position range** (e.g., positions 1–3).
  * **Exact position** (e.g., position 1 only).
  * And any additional conditions (e.g. member's segments, custom attribute etc.)

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

* Add one or more **rewards**:
  * Add units
  * Deduct units
  * Give reward
  * Set/Remove member custom attributes

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

{% hint style="danger" %}
When using **Add Units -** if points are added to the wallet used for the Leaderboard tracking, the member can artificially increase their rank.
{% endhint %}
{% endstep %}

{% step %}
**Set Leaderboard Budget**

Limit how many units can be rewarded:

* Unlimited
* Per month
* In total

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

{% hint style="info" %}
Limitations of the rewards redemption are set up in each reward's configuration.
{% endhint %}
{% endstep %}

{% step %}
**Save and Confirm**

The reward logic is applied automatically at the end of each cycle.
{% endstep %}
{% endstepper %}

***

## 📖 Example

* **Leaderboard Duration:** 1 Sep – 30 Sep
* **Reward Rule:** Top 3 members each month receive 100 points.
* **Outcome:** On 30 Sep, the top 3 members receive 100 points each.

If the leaderboard was extended to **15 Oct**, the top 3 would also receive rewards on 1 Oct (monthly cycle) and again on 15 Oct (leaderboard end).

***

## ✅ Summary

The **Rewarding Cycle** lets you automate reward distribution for leaderboard participants, ensuring fair recognition for top performers each month. With flexible rules for **positions, ranges, and reward types**, it supports everything from **monthly competitions** to **long-term leaderboard challenges**.


---

# 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/rewarding-cycle.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.