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

# Set up referral

> Turn on referral in bitLoyalty, set the points for the referrer and the friend, and share referral links with your customers.

Referral lets customers invite friends with a personal link. When the friend's first qualifying order is paid, both earn points. It works for Shopify and Commerce on WhatsApp, with no extra subscription.

For the rules behind a referral, see [Understanding referral](https://knowledge.bitbybit.studio/loyalty/understanding-referral.md).

## Prerequisites

* **Shopify:** your store is connected through **bitLogin** and the referral script is active on your Online Store theme.
* **Commerce:** WhatsApp is connected to your workspace.
* Customers are identified in **Customers**. Anonymous chat widget visitors don't get a link.

## Turn on referral

**1. Open the Referral settings**

* Open [**bitLoyalty > Earn points**](https://app.bitbybit.studio/loyalty/earn-points).
* In **Ways to earn**, click **Manage** on the **Referral** card.

The card shows **Active** when referral is on and **Paused** when it is off.

![Ways to earn list on the Earn points page, with the Referral card showing an Active label and a Manage button.](https://mintcdn.com/asmaraku/RW8xKVEP7IzD5HXi/images/loyalty/referral-ways-to-earn-card.png?fit=max\&auto=format\&n=RW8xKVEP7IzD5HXi\&q=85\&s=7c05e28f8cc8e9dd144dfc8b1b4b5a55)

**2. Enable the program**

* Switch on **Enable referral program**.

The first time, bitbybit creates a link for each identified customer you already have. Referral shows **Preparing** until this finishes, then **Ready**. Customers identified later get a link automatically.

**3. Set the rewards**

Under **Rewards**:

* **Points for the referrer** *(required)* — points the inviting customer earns. Default and minimum: `1`.
* **Points for the friend** *(required)* — points the invited friend earns. Default and minimum: `1`.
* **Minimum purchase** *(optional)* — the friend's order must reach this amount.
* **Quota per referrer** *(optional)* — the most friends one referrer can earn points for. Leave empty for no limit.

Points are given as soon as the friend's order is paid, and taken back if it is refunded or cancelled.

![Referral settings page with the Enable referral program switch on and the Rewards card showing Points for the referrer, Points for the friend, Minimum purchase, and Quota per referrer.](https://mintcdn.com/asmaraku/RW8xKVEP7IzD5HXi/images/loyalty/referral-settings.png?fit=max\&auto=format\&n=RW8xKVEP7IzD5HXi\&q=85\&s=2ff6e57f69834ebd9b64a4fe442b654e)

## Share referral links

Each customer has one link per channel. They can get it in any of these ways:

> [accordion] Ask the AI agent in chat
>
> The AI agent replies with the customer's own link for the channel they're chatting on.
>
> ![WhatsApp chat where a customer asks for their referral link and the AI agent replies with their personal link and an Open Referral Link button. The customer's name is hidden.](https://mintcdn.com/asmaraku/RW8xKVEP7IzD5HXi/images/loyalty/referral-ai-chat-reply.png?fit=max\&auto=format\&n=RW8xKVEP7IzD5HXi\&q=85\&s=1c2a553a05ad9e6a085050db1e925554)

> [accordion] Use the Refer a friend card on your Shopify store
>
> Signed-in customers see the card on your store's Loyalty page.
>
> ![Shopify store Loyalty page with the Refer a friend card showing the customer's referral link and a Copy link button.](https://mintcdn.com/asmaraku/RW8xKVEP7IzD5HXi/images/loyalty/referral-shopify-store-card.png?fit=max\&auto=format\&n=RW8xKVEP7IzD5HXi\&q=85\&s=5efa2c193559a47dc5459753bd68cbf1)

> [accordion] Copy it from the customer detail page
>
> Use this to send a link yourself, for example during a live chat.
>
> * Open **Customers** and click into the customer.
>
> * Click **Referral**, next to **Merge customer data**.
>
>   ![Customer detail header with the Merge customer data, Referral, and Delete customer buttons.](https://mintcdn.com/asmaraku/RW8xKVEP7IzD5HXi/images/loyalty/referral-customer-detail-button.png?fit=max\&auto=format\&n=RW8xKVEP7IzD5HXi\&q=85\&s=d74c6e0b46e9f886b8a51c2f3b68c7de)
>
> * Under **Links to send**, click **Copy** next to the Commerce or Shopify link.
>
>   ![Referral pop-up on the customer detail page with two rows under Links to send, one for Commerce and one for Shopify, each with a Copy button.](https://mintcdn.com/asmaraku/RW8xKVEP7IzD5HXi/images/loyalty/referral-customer-detail-popup.png?fit=max\&auto=format\&n=RW8xKVEP7IzD5HXi\&q=85\&s=4aa740c84e30bed8fe94a21614810f1c)

> [accordion] Send it in a campaign
>
> Send each customer their own link in a WhatsApp campaign. See [Send referral links in a campaign](https://knowledge.bitbybit.studio/loyalty/how-to-blast-referral-links-with-a-campaign.md).

> [!NOTE]
>
> A link is hidden while referral is off or **Preparing**, when its channel isn't ready, or when the referrer has reached your quota.

## Review your referrals

Open **Referral > History** to see every invited friend and the points given. See [Referral history reference](https://knowledge.bitbybit.studio/loyalty/referral-history-reference.md).

## Related

* [Understanding referral](https://knowledge.bitbybit.studio/loyalty/understanding-referral.md)
* [Send referral links in a campaign](https://knowledge.bitbybit.studio/loyalty/how-to-blast-referral-links-with-a-campaign.md)
* [Reward options](https://knowledge.bitbybit.studio/loyalty/reward-options.md)
* [bitLoyalty overview](https://knowledge.bitbybit.studio/loyalty/overview.md)


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