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

# Referral history reference

> Reference for the Referral history page: summary cards, search and filters, how people are shown, and CSV export.

The **Referral history** page lists every friend invited through your referral program, what happened to their order, and the points given. Merchants see this page; customers never see referral history.

To open it, go to [**bitLoyalty > Earn points**](https://app.bitbybit.studio/loyalty/earn-points), click **Manage** on the **Referral** card, then click **History**.

![Referral history page with three summary cards, a search box, Status and Channel filters, an Export CSV button, and a table of referrals with Date, Referrer, Referred, Channel, Order, Status, and Points given columns. Customer names are hidden.](https://mintcdn.com/asmaraku/RW8xKVEP7IzD5HXi/images/loyalty/referral-history.png?fit=max\&auto=format\&n=RW8xKVEP7IzD5HXi\&q=85\&s=a01022218d9290a0441c48187a2760e4)

## Summary cards

| Card | What it means |
| - | - |
| **Rewarded referrals** | The number of referrals where the friend's order qualified and points were given. |
| **Net points given** | Points given to referrers and friends, after subtracting points taken back from reversed referrals. |
| **Reversed** | The number of referrals reversed because the friend's order was refunded or cancelled. |

## Search, filters, and export

* **Search** — find a referral by referrer, friend, or order number.
* **Status** filter — show one referral status: **Pending**, **Rewarded**, **Rejected**, or **Reversed**. See [Referral statuses](https://knowledge.bitbybit.studio/loyalty/understanding-referral.md#referral-statuses) for what each one means.
* **Channel** filter — show Shopify or Commerce referrals only.
* **Export CSV** — download the referral list as a CSV file.
* **Show** — choose how many entries appear per page. The default is 25.

If nothing has been referred yet, the page shows `No referrals yet` and explains that referrals appear once a customer's friend opens their link and buys.

## How people are shown in the list

Each row shows the referrer's name. The friend is shown using the first detail available:

1. The friend's name, if bitbybit recognised them.
2. On Commerce, the WhatsApp number they messaged from, partly masked.
3. On Shopify, the order email, then the order phone number (partly masked), then the order number, for example `#1043`.

Open a referral to see its timeline.

## Related

* [Set up referral](https://knowledge.bitbybit.studio/loyalty/how-to-set-up-referral.md)
* [Understanding referral](https://knowledge.bitbybit.studio/loyalty/understanding-referral.md)


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