Skip to main content

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.

Your profile represents you on TeamBattles. Customize it to stand out and control who can see your information.

​
Profile Fields

​
Required Fields

FieldRequirements
Display Name1-50 characters
Username3-30 characters (letters, numbers, underscores only)

​
Optional Fields

FieldLimit
Bio500 characters
Pronouns50 characters
BirthdayDate
Country2-letter code
TimezoneStandard timezone
LanguagesUp to 10

​
Profile Images

ImageSize LimitBehavior
Avatar1 MBReplaces previous
Banner2 MBReplaces previous
When you upload a new image, the old one is automatically replaced. There’s no image history.

​
Profile Visibility

Control who sees your profile:
LevelWhat Others See
PublicFull profile: bio, stats, teams, achievements
LimitedBasic info: name, username, avatar
PrivateNothing (only you can see)
To change visibility:
  1. Go to Settings > General
  2. Find Profile Visibility
  3. Select your preferred level

​
Your Statistics

Your profile displays your competitive performance:
  • Experience - Earned from matches and objectives
  • Wins / Losses / Draws - Your match record
  • Current Streak - Consecutive results (positive = wins)
  • Best Streak - Your longest win streak

​
Profile URLs

Share your profile with others:
TypeURL Format
Your Profile/profile/{username}
Team Profile/team/{id}
Organization/org/{id}
Match/matches/{id}
Your username creates a clean, shareable URL like teambattles.gg/profile/your_name.

​
Sharing Your Profile

When you share your profile link on social media, messaging apps, or platforms like Discord, a rich preview card is automatically generated showing your profile information.

​
What’s Included in the Preview

The social preview card displays:
  • Your avatar - Profile picture
  • Your banner - Background image (if set)
  • Display name - Your public name
  • Username - Your @handle
  • Win/Loss record - Your match statistics

​
Using the Share Menu

To share your profile:
  1. Visit any profile page (yours or another user’s)
  2. Click the Share button
  3. Choose an option:
    • Copy Link - Copies the profile URL to your clipboard
    • Download Image - Downloads the preview image directly

​
Direct OG Image URLs

You can also access profile preview images directly:
Profile TypeURL Format
User/og/profile/{username}.png
Team/og/team/{slug}.png
Organization/og/org/{slug}.png
Query Parameters:
ParameterValuesDefaultDescription
themedark, lightdarkImage color theme
downloadtrue-Triggers file download
Example: 
https://teambattles.gg/og/profile/your_name.png?theme=light
Preview images are automatically cached and regenerate when you update your profile picture, banner, or display name.