> ## 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.

# bitLoyalty overview

> What bitLoyalty is, what shipped in v1, and how to prepare your store to use it.

bitLoyalty is bitbybit's first-party loyalty program. It runs inside your bitbybit workspace alongside bitCRM, bitChat, and bitApp, so the customer record, chat surfaces, and automation triggers all read from the same loyalty ledger.

## What you can do with bitLoyalty

* **Award points on purchase.** Points accrue from Shopify orders at the earning rate you configure.
* **Set an earning rate.** One conversion in the format `{currency amount} = {points}` (for example, `Rp 10,000 = 1 Point`).
* **Create reward vouchers.** Fixed-amount discount vouchers that customers redeem with their points.
* **Set voucher expiration.** Each reward chooses a validity window per generated voucher — **No expiration**, **7 days**, **30 days**, **90 days**, or **1 year**. The countdown starts when the voucher is generated for a customer, not when the reward is created.
* **Adjust points manually.** Admins can add or deduct points on a customer with a required reason (`Manual adjustment`, `System issue`, `Order adjustment`, `Promotion`, `Offline purchase`, `Bonus`, `Other`).
* **Redeem points on behalf of a customer.** Admins can turn a customer's points into a voucher from the customer detail page.
* **Track history per customer.** Points history (filterable by `Points Added` / `Points Deducted`) and a redeemed-vouchers table with statuses (`Active`, `Used`, `Expired`).
* **Surface Loyalty in bitChat.** The chat widget can show shoppers their balance and browsable rewards; the livechat info panel shows the same balance to agents in real time.
* **Trigger bitCRM automations.** `Points earned`, `Points redeemed`, `Points adjustment`, and `Reward expiring` are available as triggers.

## Prerequisites

* A Shopify store connected to your bitbybit workspace via the **bitLogin** integration. If Shopify is not connected, the bitLoyalty pages render a **You're not connected to Shopify. Connect now to start using bitLoyalty** banner and disable the enable/reward controls.
* Your bitbybit workspace currency **matches** your Shopify store currency. bitLoyalty prompts you to verify this the first time you enable the program via a **Quick currency check!** modal; a mismatch causes points to accrue at the wrong rate.

## Where Loyalty data appears

* **bitLoyalty > Earn points** — the enable toggle and the currency-to-points conversion.
* **bitLoyalty > Reward option** — the reward list, create/edit form, and per-reward redemption detail.
* **Customers > (customer detail)** — the Loyalty balance card (points, total earned, redeemed), points history, and redeemed vouchers table.
* **bitChat > Chat widget settings > Loyalty points** — controls whether the widget shows points and rewards to shoppers.
* **bitChat > Livechat info panel > Loyalty** — read-only current balance and recent activity for agents.
* **bitCRM > Automations** — Loyalty triggers.

## Next steps

* [Quickstart: Turn on bitLoyalty in 10 minutes](/loyalty/quickstart)
* [Reward options reference](/loyalty/reward-options)