# Referrals

## What is the Referrals module?

The Referrals module allows you to create campaigns where loyalty members can invite new users to join your program. Both the person who shares the referral (**referrer**) and the friend who joins (**friend**) can earn rewards when campaign rules are met.

{% hint style="info" %}
Modules are sold separately and **not included** in the Loyalty Engine core platform licence. For pricing and details, contact your account manager.&#x20;
{% endhint %}

### Key terms

<table data-header-hidden><thead><tr><th width="191.21484375" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Referral campaign</strong></td><td valign="top">A set of rules defining when and how rewards are given for referrals.</td></tr><tr><td valign="top"><strong>Referral code</strong></td><td valign="top">A unique code each user can share with friends to register.</td></tr><tr><td valign="top"><strong>Referrer</strong></td><td valign="top">The existing loyalty member who shares their referral code.</td></tr><tr><td valign="top"><strong>Friend</strong></td><td valign="top">The new user who registers using the referral code.</td></tr><tr><td valign="top"><strong>Sequence step</strong></td><td valign="top">A condition that must be met for a referral to be considered valid and a reward to be given.</td></tr></tbody></table>

***

## How the Referrals module works

{% stepper %}
{% step %}

### Campaign setup

* Admins create a referral campaign and define rules for what makes a referral valid.
* Rules can be based on any event in the platform (e.g., completing registration, making a purchase, reaching a spend threshold).

<a href="/pages/MCnUXIlNscKXigcLdnwT" class="button primary">Creating referral campaigns</a>
{% endstep %}

{% step %}

### User sharing & friend registration

* Each user is given a unique referral code or link to share with friends.
* A friend enters the referral code during sign-up to link the referral.
* The referral is then tracked in the Loyalty Engine.

<a href="/pages/bWpQgetGIKYwR94QGldC" class="button primary">Referring a friend</a>
{% endstep %}

{% step %}

### Rules triggered

* As the friend takes actions (e.g., first purchase over $50), the system checks the referral campaign rules.
* Rewards can be given to the friend, the referrer, or both – depending on the campaign setup

> #### Example
>
> A campaign might have these sequence steps:
>
> 1. When the friend registers, both receive 500 points.
> 2. When the friend then makes their first purchase over $50, the referrer receives 1,000 points.
> 3. If the friend makes five more purchases, both receive a voucher.
>    {% endstep %}
>    {% endstepper %}

***

## FAQs

#### Is there a limit to how many people someone can refer?

Referral codes can be used unlimited times, but each friend can only use a code once at registration.

#### Can an existing user apply a referral code?

No. Referral codes only work during [new user registration](mailto:undefined).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kbase.whitelabel-loyalty.com/product/modules/referrals.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
