The bitLoyalty > 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. |
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.
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.
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.
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). |
This reward has not been redeemed.
Related pages
- Overview — what shipped in v1.
- Quickstart — enable Loyalty and create your first reward end-to-end.
