How It Works
- Share your unique referral code, link, or QR code with friends
- They sign up for TeamBattles - you earn your first reward
- As they play matches, you earn additional milestone rewards
- Once they play 50+ matches, they “graduate” and free up a referral slot
Finding Your Referral Code
Ways to Share
| Method | Description |
|---|---|
| Code | Share your referral code directly - new users enter it during setup |
| Link | Copy a shareable URL in the format https://teambattles.gg/ref/[code] |
| QR Code | Display or download a QR code for in-person sharing |
What Happens When Someone Uses Your Link
- They visit your referral link (
https://teambattles.gg/ref/[code]) - A tracking cookie is saved in their browser (valid for 30 days)
- When they sign up, you are credited as the referrer
- During profile setup, your referral code is pre-filled automatically
- You receive a notification that someone signed up with your referral
Milestone Rewards
You earn token rewards as your referred users reach each milestone:| Milestone | Matches Played | Tokens Earned |
|---|---|---|
| Sign Up | 0 | 10 |
| First Match | 1 | 25 |
| 5 Matches | 5 | 50 |
| 10 Matches | 10 | 100 |
You receive a notification each time one of your referrals reaches a new milestone.
Referral Cap and Graduation
You can have up to 25 active referrals at a time. Once a referred user plays 50 or more matches, they “graduate” and free up an active referral slot.- Graduated referrals still appear in your dashboard and count toward your stats
- Graduation happens automatically - no action needed from you
- Once a slot opens, you can refer someone new
Viewing Your Referral Dashboard
The Referrals page shows a complete overview of your referral activity:- Summary cards - Total referrals, active referrals, tokens earned, graduation count
- Referral list - All referred users with their current status and milestone progress
- Sharing tools - Your code, link, and QR code for easy access
Tracking Your Referral Progress
If you were referred by another user, a progress section appears at the bottom of the Referrals page. This shows:- Who referred you - Your referrer’s avatar and username
- Match progress - A progress bar tracking your matches played toward the 50-match graduation threshold
- Milestones - Visual indicators for signup, first match, 5 matches, and 10 matches
- Graduated status - Once you play 50+ matches, the section updates to show that you’ve completed your referral journey
Entering a Referral Code
If someone referred you to TeamBattles:Enter Code
Type in the referral code you received (or it may be pre-filled if you used a referral link)
Referral codes can only be entered during initial profile setup. If you skip this step, you cannot
add a referral code later.
Troubleshooting
“My referral link didn’t track the signup”- The tracking cookie expires after 30 days
- The user may have cleared their cookies before signing up
- The user may have signed up on a different browser or device
- You can have up to 25 active referrals at a time
- Wait for existing referrals to graduate (50+ matches played) to free up slots
- Tokens are awarded when your referral reaches each milestone
- Check your referral dashboard for the current status
- Milestone rewards may take a moment to process