> ## Documentation Index
> Fetch the complete documentation index at: https://docs-builder.nativelyai.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Referral program
> Invite friends to native.builder with your personal referral link and earn credits as they sign up, publish, upgrade, and stay active.
Every **native.builder** account gets a personal referral link. Share it with people you know — as they sign up, publish their first app, upgrade to a paid plan, and stay active, you both earn credits toward your workspace balance.
Referral rewards are evergreen and automatic. There are no seasonal campaigns to track and no manual claim forms — milestones grant credits when they happen.
## How it works
Open the referral page in the app to copy your personal link. It is unique to you and stays the same over time.
Send it however you like — chat, email, or social. Anyone who creates an account through your link becomes your referral.
They get a welcome bonus right away. If someone opens more than one referral link before signing up, **only the first link used** counts.
When your friend [publishes](/features/publish) their first app, you both earn credits. That first publish is also what qualifies the referral for ambassador progress.
If they move to any paid plan, you earn a larger bonus. Extra rewards unlock when they stay active over time.
## What you both earn
| Event | Your friend (referee) | You (referrer) |
| ------------------------------------ | --------------------- | -------------- |
| Signs up with your referral link | +20 credits | — |
| Publishes their first app | +10 credits | +10 credits |
| Upgrades to any paid plan | — | +30 credits |
| Stays active for 30 consecutive days | — | +10 credits |
| **Maximum per referral** | **30 credits** | **50 credits** |
You do **not** earn credits just because someone signed up. Your first reward for a referral is when they publish an app — that keeps rewards tied to real usage, not empty accounts.
Referral credits land in the recipient's own [workspace credit pool](/introduction/plans-and-credits) — the same balance used for chat, code generation, and other AI-powered features.
## When rewards post
| Reward | Timing | Notes |
| --------------------------- | --------------------------------- | ------------------------------------------------------------------- |
| Friend signup bonus (20) | Immediate | Unused signup-bonus credits expire after **30 days** |
| First-publish (10 + 10) | Held \~**14 days**, then released | Review window before credits become available |
| 30-day activity (10 to you) | Held \~**14 days**, then released | Same review window as other non-paid milestones |
| Paid-plan bonus (30 to you) | Immediate | Once per referred friend, when they move from Free to any paid plan |
Paid-plan rewards post right away because they are tied to a real subscription. Milestone rewards that are not backed by a paid conversion stay pending briefly so Builder can review for abuse before they are granted.
Builder may hold, pause, or reverse credits earned through fraudulent or abusive referrals.
## Ambassador status
Qualified referrals unlock permanent status. A **qualified referral** means your friend has published at least one app — not only signed up.
| Milestone | Status | Bonus | Perks |
| ------------------------ | -------------- | ------------ | ----------------------------------------------------------- |
| 1 qualified referral | **Connector** | +10 credits | Referral dashboard unlocked |
| 5 qualified referrals | **Advocate** | +50 credits | Exclusive template pack, profile badge |
| 15 qualified referrals | **Ambassador** | +150 credits | Early feature access, Ambassador badge, community spotlight |
| 50 qualified referrals | **Champion** | +500 credits | Free Pro for 1 month, direct product feedback channel |
| 100+ qualified referrals | **Partner** | Custom | Partnership and co-marketing discussion |
Status is cumulative and permanent once earned — it does not reset.
## Referral credits and caps
| Topic | Rule |
| ---------------------- | ------------------------------------------------------------------------------------------------------- |
| Where credits go | Recipient's workspace balance |
| Signup bonus expiry | Unused referee signup bonus expires after **30 days** |
| Other referral rewards | Referral rewards follow Builder credit lifecycle rules (use them while they are active on your balance) |
| Per-referral ceiling | Up to **50** for you / **30** for your friend from the core event table |
| Paid conversions | **No earnings cap** — every paid friend can grant the paid-plan bonus |
| Non-revenue milestones | Bounded monthly so free-tier farming cannot run unbounded |
Principle: if your friend is paying for Builder, your conversion-aligned rewards stay open. If they stay on Free, non-revenue milestone earnings are bounded.
## Fair play
* **First link wins** — if someone opens multiple referral links, only the first one used gets credit.
* **No self-referral** — you cannot refer yourself, including through another email, alias (`you+1@…`), or account you control.
* **New users only** — your friend must be a genuinely new native.builder user.
* **Good standing** — accounts flagged for abuse may have referral rewards paused.
* **Review holds** — publish and activity rewards can stay pending while Builder reviews unusual patterns (for example, many signups in a short window, or publish immediately after claim).
## In the app
The referral experience is meant to stay light — no interruptive pop-ups. You will typically find:
* Your **unique referral link** and a one-tap copy action
* **Stats** such as link clicks, signups, qualified referrals, and paid conversions
* **Earnings** — credits earned, credits still pending in the review hold, and lifetime referral totals
* **Ambassador progress** toward the next tier
* Soft prompts in natural moments (onboarding, while an agent is building, after publish, when credits run low, and under billing/settings)
Exact UI placement can evolve as the program rolls out; the rewards and rules on this page are the source of truth for how earning works.
## Next steps
See how referral credits fit into your workspace balance.
Publishing is what qualifies a referral and unlocks the first dual-sided reward.
New to native.builder? Create your first project.
Credits are shared across everyone in your workspace.