# Referrals

Fuul lets you set up incentives to encourage affiliates, KOLs, and users to bring new participants to your project through referrals. Referrals are the core growth mechanism — they connect attribution, reward structures, and affiliate management into a single system.

## How referrals work

1. An affiliate generates a tracking link or code
2. A user clicks the link and connects their wallet → [Attribution](https://docs.fuul.xyz/core-concepts/referrals-and-attribution) determines which referrer gets credit
3. The user converts (trades, deposits, etc.) → rewards are calculated based on the reward structure
4. Payouts are distributed to the referrer (and optionally to the referred user)

## Referral reward structures

Once attribution is set up, you can configure how rewards flow through the referral chain:

| Structure                               | Description                                                                                    | Guide                                                                                       |
| --------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| **Multi-level referrals**               | Reward up to 3 levels of the referral chain (direct referrer + their referrer + one more)      | [Multi-Level Referrals](https://docs.fuul.xyz/core-concepts/referrals/multilevel-referrals) |
| **Sharing rewards with referred users** | Affiliates share a portion of their commission with the users they refer (double-side rewards) | [Sharing Rewards](https://docs.fuul.xyz/core-concepts/referrals/double-side-rewards)        |
| **Tiered rewards**                      | Different reward rates based on affiliate performance, volume, or audience segment             | [Tiers & Multipliers](https://docs.fuul.xyz/core-concepts/tiers-and-multipliers)            |

## Referral codes vs affiliate codes

Fuul offers two types of codes for referral tracking:

|                | Affiliate codes                                     | Referral codes                                           |
| -------------- | --------------------------------------------------- | -------------------------------------------------------- |
| **Created by** | The affiliate (with a wallet signature)             | The project (on behalf of users)                         |
| **Format**     | Custom (e.g., `my-brand`)                           | Auto-generated (7-char alphanumeric)                     |
| **Used in**    | Tracking links (`?af=code`) — automatic attribution | Accepted explicitly by the user — permanent relationship |
| **Scope**      | Cross-project                                       | Single project                                           |

See [Affiliate Codes vs Referral Codes](https://docs.fuul.xyz/core-concepts/referral-codes-vs-invite-codes) for the full comparison.

## Related pages

| Topic                             | Guide                                                                                              |
| --------------------------------- | -------------------------------------------------------------------------------------------------- |
| How attribution assigns credit    | [Attribution](https://docs.fuul.xyz/core-concepts/referrals-and-attribution)                       |
| Track referrals in your app (SDK) | [Tracking Referrals](https://docs.fuul.xyz/developer-guide/tracking-referrals-in-your-app)         |
| Create affiliate links and codes  | [Affiliate Links & Codes](https://docs.fuul.xyz/developer-guide/creating-affiliate-links-or-codes) |
| Manage referral codes             | [Referral Codes](https://docs.fuul.xyz/developer-guide/referral-codes)                             |
| Build an affiliate dashboard      | [Affiliate Dashboard](https://docs.fuul.xyz/developer-guide/affiliate-dashboard)                   |
| Manage affiliate applications     | [Affiliate Applications](https://docs.fuul.xyz/core-concepts/affiliate-applications)               |