> For the complete documentation index, see [llms.txt](https://docs.fuul.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fuul.xyz/core-concepts/referrals/multilevel-referrals.md).

# Multi-Level Referrals

Fuul supports up to **4 levels** of referral attribution, allowing you to reward not just the direct referrer, but also the affiliates who brought them into the program.

## How it works

| Level       | Who                             | Example                                                                     |
| ----------- | ------------------------------- | --------------------------------------------------------------------------- |
| **Level 1** | Direct referrer (the affiliate) | Alice refers Bob                                                            |
| **Level 2** | Referrer's referrer             | Carol referred Alice, who referred Bob                                      |
| **Level 3** | Third level up the chain        | Dave referred Carol, who referred Alice, who referred Bob                   |
| **Level 4** | Fourth level up the chain       | Eve referred Dave, who referred Carol, who referred Alice, who referred Bob |

When Bob converts, all four levels can receive a payout — each with its own amount or percentage, configured in the incentive rules.

## Per-tier multi-level amounts

When using audiences (tiers), each tier can define its own multi-level payout amounts independently. For example:

* **Standard tier**: Level 1 = 5%, Level 2 = 2%
* **VIP tier**: Level 1 = 10%, Level 2 = 5%, Level 3 = 2%, Level 4 = 1%

This lets you reward higher-performing affiliates with better rates at every level of their referral chain, not just at the top level.

## Viewing multi-level data

The [Affiliate Dashboard](/developer-guide/affiliate-dashboard.md) provides multi-level stats that distinguish between referral levels:

| Level                                                | Description                                            |
| ---------------------------------------------------- | ------------------------------------------------------ |
| **Level 1 (referred\_volume)**                       | Volume from users directly referred by the affiliate   |
| **Level 2 + Level 3 + Level 4 (multilevel\_volume)** | Volume from second, third, and fourth-degree referrals |
| **Total (total\_volume)**                            | Combined Level 1 + Level 2 + Level 3 + Level 4 volume  |

Affiliates can also view their full referral tree to understand how their network generates value.