Grow the TeamBattles community by referring friends. When someone signs up using your referral and plays matches, you earn token rewards at key milestones.Documentation Index
Fetch the complete documentation index at: https://teambattles.gg/docs/llms.txt
Use this file to discover all available pages before exploring further.
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