Widget Reference

The Battles Overlay includes 7 core widgets plus game-specific rank widgets you can toggle on and arrange on your stream. Each widget displays different competitive data and requires specific API permissions.

​

Widget Overview

​

User Stats

Displays your personal competitive statistics. Data shown:

• Wins and losses
• Win rate percentage
• Current win/loss streak
• Experience points (XP)

Default size: ~300x120px Required permission: stats.user_stats: read

​

Team Stats

Displays stats for your selected team. You must select a team in the editor for this widget to populate. Data shown:

• Team name, tag, and logo
• Game the team competes in
• Wins and losses
• Win rate percentage
• Current streak

Default size: ~300x120px Required permissions:

• stats.team_stats: read
• A team must be selected in the editor context settings

​

Organization Stats

Displays stats for your selected organization. You must select an organization in the editor for this widget to populate. Data shown:

• Organization name and logo
• Member count
• Wins and losses
• Win rate percentage

Default size: ~280x100px Required permissions:

• stats.org_stats: read
• An organization must be selected in the editor context settings

​

Active Match

Displays your current live match in a VS layout. This widget automatically shows and hides based on whether you have an active match. Data shown:

• Team logos and names (VS layout)
• Current scores
• Match type and best-of series (e.g., “Best of 3”)
• Current map name (when applicable)
• Match status label: LIVE, READY, or UPCOMING
• Pulsing live indicator dot when the match is in progress

Default size: ~400x150px Required permission: matches.user_matches: read

​

Leaderboard Rank

Displays your current rank on the global leaderboard. Data shown:

• Your rank position (e.g., “#12”)
• Total players on the leaderboard
• Win rate
• XP

Default size: ~200x80px Required permission: leaderboard.user_rank: read

​

Top 3 Players

Displays the top 3 players from the global leaderboard. Data shown (per player):

• Rank position
• Player name
• Avatar
• Win rate

Default size: ~250x180px Required permission: leaderboard.top_players: read

​

Referral Code

Displays your referral code and total referral count. Useful for streamers who want viewers to sign up using their code. Data shown:

• Your unique referral code (monospace, accent-colored)
• Total number of referrals

Default size: ~200x80px Required permission: stats.user_stats: read

​

Game Rank Widgets

Game-specific rank widgets display your competitive rank for supported games. These are found in the Game Specific tab of the editor. Data shown:

• Rank badge/icon for the game
• Tier or division name
• Skill Rating (SR) value
• Progress bar toward next rank (when applicable)

Default size: ~320x100px Required permission: game.game_rank: read Each supported game can have multiple rank modes (e.g., Ranked Play, Warzone Ranked). You can enable each mode independently and they appear as separate widgets. Game rank widgets also support:

• Animation - Toggle video effects like winstreak flames on or off in the editor’s style controls
• Orientation - Display the widget horizontally (default) or vertically via the style controls

​

Permissions Summary