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

# Reward options

> Field reference for the reward list, create/edit form, and per-reward redemption metrics.

The [**bitLoyalty > Reward option**](https://app.bitbybit.studio/loyalty/reward-option) page is where you define the vouchers customers can redeem with their points, and where you inspect who has redeemed what.

## Reward list

The main page shows every reward you've created, plus an **Add reward** button in the top right. If you haven't created any rewards yet, an empty state prompts you to `Create your first reward to show customers exactly what they can redeem their points for.`

### Columns

| Column | What it means |
| - | - |
| **Name** | The reward name, followed by a small pill showing either the voucher prefix (e.g. `50DISC`) or `Random code` if you left the prefix blank at create time. |
| **Points required** | Cost to redeem — how many points a customer spends to generate one voucher of this reward. |
| **Discount value** | The currency amount discounted at checkout when the voucher is applied. |
| **Min. purchase** | The minimum order subtotal required for the voucher to be usable at checkout. |
| **Total redeemed** | Lifetime count of vouchers generated from this reward, across all customers. A "redemption" means a customer spent points and received a voucher code — it does not necessarily mean the voucher was used at checkout. Click the `{n} times` link in this cell to open the reward detail page for the full breakdown. |

Use the search box to filter the list by reward name. Select rows and use **Delete reward options (n)** to bulk-delete.

<Note>
  Deleting a reward removes it from future redemptions but does not invalidate vouchers already in customer wallets — customers can still use vouchers they redeemed before the reward was deleted.
</Note>

## Create or edit a reward

Click **Add reward** to open the create form. Editing an existing reward opens the same form, but only **Reward name** is editable — every other field is locked and greyed out.

### Basic details

* **Reward name** *(required)* — customer-visible label. Shown wherever the reward is offered (chat widget, redeem-points modal, etc.).
* **Cost to redeem (points required)** *(required)* — must be greater than 0. This is how many points the customer spends when they redeem this reward.

### Discount configuration

* **Discount type** — only **Fixed amount** is available in v1. **Percentage** is shown as a tile but marked *Coming soon* and cannot be selected.
* **Discount value** *(required)* — the currency amount discounted at checkout. Must be greater than 0.
* **Voucher prefix** *(optional, up to 12 characters, auto-uppercased)* — prepended to each generated voucher code so the code reads `PREFIX-XXXXXX`. Leave blank to fully auto-generate the code — the form preview will render `AUTO-XXXXXX` as a placeholder.

### Order requirements

* **Minimum purchase amount** *(required)* — the customer must spend at least this amount at checkout for the voucher to apply. Enter `0` if there is no minimum.

### Voucher expiration

* **Voucher is valid for** *(required)* — how long each individual voucher stays usable once it's generated for a customer. Options:
  * **No expiration**
  * **7 days**
  * **30 days**
  * **90 days**
  * **1 year**

The countdown starts the exact moment the voucher is generated for a customer (either through the customer detail page or through an automated flow), **not** when you save the reward. Changing this setting on a new reward affects only vouchers generated from that point forward.

<Warning>
  Once a reward is saved, only **Reward name** can be edited. Points required, discount value, voucher prefix, minimum purchase, and voucher expiration are all locked. If any of these need to change, create a new reward and delete the old one.
</Warning>

## Reward detail page

Clicking a reward name — or the `{n} times` link in the **Total redeemed** column — opens the reward detail page.

### Summary tiles

* **Total redeemed voucher** — the number of vouchers generated from this reward across all customers. This counts *any* voucher creation, including vouchers that were later expired unused.
* **Actually used at checkout** — of those generated vouchers, how many were actually applied to a real Shopify order. The gap between the two tiles tells you how many vouchers are sitting unused (or expired unused) in customer wallets.

### Redemption history

Every voucher generated for this reward is listed in the table below the tiles.

| Column | What it means |
| - | - |
| **Customer** | The customer who spent the points, followed by the generated voucher code and a copy button. |
| **Points spent** | How many points were deducted from the customer's balance when the voucher was generated. |
| **Date generated** | When the voucher was created. |
| **Status** | `Unused` — the voucher exists in the customer's wallet but hasn't been applied to a Shopify order yet. `Used` — the voucher has been applied at checkout. `Expired` — the voucher's validity window ended before it was used. |
| **Source** | How the voucher was generated. Values: the CS agent's name (if a specific CS user redeemed it from the customer detail page), `Manual CS` (a CS-issued voucher without an attributed user), or `AI generated` (created via an automated flow such as a bitCRM automation). |

If nothing has been redeemed yet, the table shows `This reward has not been redeemed`.

## Related pages

* [Overview](/loyalty/overview) — what shipped in v1.
* [Quickstart](/loyalty/quickstart) — enable Loyalty and create your first reward end-to-end.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.