# 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="https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FnIpUldJSPuFfnPyECGRb%2Fimage.png?alt=media&#x26;token=675be4df-50d9-4286-a572-82c7f9ad6d4a" 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="https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FHgky26suAM7VPqV2GXpu%2Fimage.png?alt=media&#x26;token=f68870f4-f362-4ea6-ab53-fede64c209af" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FbR8meEtgZgPnEEVSEgRZ%2Fimage.png?alt=media&#x26;token=14cb7c52-0dab-4a84-9427-57e74c9e8391" 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="https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FPdbHeVUayN16imPEgqZr%2Fimage.png?alt=media&#x26;token=b8dbf9e1-c8c6-408f-8db0-b6ce5280c8af" 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**.