> For the complete documentation index, see [llms.txt](https://docs.pixeleyes.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pixeleyes.de/anleitungen-instructions/english/documentation-of-our-shopware-6-plugins/bonus-points-and-loyalty-program-for-shopware-6/features/invite-friends-referral.md).

# Invite friends (referral)

The referral system rewards customers who bring in new buyers.

## How it works

{% stepper %}
{% step %}

## Personal invitation link

Every registered customer receives a personal **invitation link**.
{% endstep %}

{% step %}

## Share the link

The customer shares this link via email, social media, or other channels.
{% endstep %}

{% step %}

## Friend creates an account

The invited friend opens the link and creates an account.
{% endstep %}

{% step %}

## Points are credited

After the friend's **first completed order**, both receive points:

* The **referring customer** receives the configured referrer points.
* The **new customer** receives the configured referred-customer points.

{% hint style="info" %}
Points are only credited after the first order is completed (status: "Completed").
{% endhint %}
{% endstep %}
{% endstepper %}

## Invitation link

The format of the link:

```
https://your-shop.com/ref/{referral-code}
```

The link is permanent and unique for each customer. It automatically redirects to the configured target page (default: home page).

## Display in the customer account

Under **Invite friends**, the customer sees:

* Their personal invitation link (copyable)
* A list of all invited friends
* The status per invitation (open / points credited)

## Configuration

| Setting                      | Description                            |
| ---------------------------- | -------------------------------------- |
| Enabled                      | Turn the referral system on/off        |
| Points for referrer          | Points the referring customer receives |
| Points for referred customer | Points the new customer receives       |

Details: [Configuration → Invite friends](broken://pages/29a52a16f53987b5535bb73c0c569502345b6242)

## Abuse protection

* Each email address can only count once as a referred customer.
* Self-invitations (same email address) are ignored.
* A friend can only be invited via one invitation link (first-click attribution).