# Set a total redemption limit

{% hint style="info" %}
This feature is available for **All plans**
{% endhint %}

## Overview

By default, redeeming programs have no cap on how many times customers can redeem them. Total redemption limits let you set a maximum number of redeems for any program — useful when offering limited-quantity rewards like free gifts, seasonal vouchers, or exclusive discounts.

When the limit is reached, the program is automatically marked as sold out and customers can no longer redeem it.

## How to set up

{% stepper %}
{% step %}
**Open a redeeming program**

Go to **Reward programs** → **Redeeming programs**, then select any program (Discount, Free gift, or Free shipping) to edit it.
{% endstep %}

{% step %}
**Enable redemption limit**

Scroll to the **Redemption limit** card. Choose **Redemption limit** (instead of No limitation).
{% endstep %}

{% step %}
**Set the program total limitation**

Enter the maximum number of total redeems allowed in the **Program total limitation** field (e.g. `50`).

Once this number is reached, no more customers can redeem the program regardless of their individual limits.
{% endstep %}

{% step %}
**Optionally limit per customer (optional)**

Check **Each customer's limit** to also set a per-customer cap. Enter the maximum number of times a single customer can redeem this program.

Both limits work together — the program stops when either cap is hit first.
{% endstep %}

{% step %}
**Save your changes**

Click **Save**. The program now tracks redeems and will automatically become unavailable once the total limit is reached.
{% endstep %}
{% endstepper %}

## Monitoring and resetting

Once a total limit is set, Joy shows a **Current total of redemptions** counter alongside the limit so you can track usage at a glance.

If you need to reopen a sold-out program (e.g., after restocking), click **Reset** next to the counter. This resets the count to zero and makes the program available again.

{% hint style="warning" %}
Resetting the redemption count is permanent and cannot be undone. Only completed redemptions are counted — pending or failed redeems are not included.
{% endhint %}

## How it looks to customers

When a program's total limit is reached, the reward appears as **Sold out** in the loyalty widget. Customers can see it but cannot redeem it.

## FAQ

**Does the limit reset automatically (daily, weekly)?** No. The total redemption limit does not reset on a schedule. You must reset it manually using the Reset button in the admin.

**What happens to pending redemptions when the limit is hit?** Only completed redemptions count toward the total. If a redemption is in progress when the limit is reached, it will still be processed.

**Can I change the limit after the program is live?** Yes. You can increase or decrease the limit at any time. Changes take effect immediately and do not affect existing redemptions.

**Does this work with all reward types?** Yes. Total redemption limits apply to Discount programs, Free gift programs, and Free shipping programs.


---

# 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.joy.so/reward-programs/redeeming-programs/redemption-limits.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.