Docs Teams

Documentation

Teams

Named teams with their own rosters, captains and ratings, and the team ratings that form on their own when the same players play together

Jump to Section

Overview Creating Rosters Ratings Playing Stats & Profiles Dashboard Limits FAQ

Overview

Team Up rates teams in two ways. A named team is a roster an admin saves under a team ID, and it has one rating that stays with the team when players come and go. An automatic team rating forms on its own for any group of players who play on the same side, with no setup at all.

Named teams

Created with /team_admin or on the dashboard's Teams page
Named in commands by their team ID, for example phoenix
One rating for the team, whoever plays for it that night
Played with /record_match team_alias, team queues and team tournaments
A display name, tag, logo, colors and a public team page

Automatic team ratings

No setup: any match where every side has the same number of players, two or more, also rates each side as a group
Tied to the exact set of players: swap one player and it is a different team
Players' own ratings move as usual
Shown with /leaderboard display_leaderboard rating_type:Team

Do you need a named team? Not for pickup games: queue or record 3v3s with any players and everyone keeps their own rating (each trio gets an automatic team rating too). Save a named team for a fixed roster that should keep one rating, like a clan team or a league's franchises.

Creating a Team

Admins create named teams in Discord with /team_admin create (Manage Server by default), or on the dashboard under League → Teams → New team. It is the same team either way: one made on the web works with /record_match team_alias, /team_admin and team queues, and a roster change made in either place shows in the other.

/team_admin create team_id:phoenix team_size:5 members:@p1 @p2 @p3 @p4 @p5

Team ID

2 to 32 characters: letters, numbers, hyphens and underscores, no spaces
Must be unique in the league. A few reserved words are refused (default, admin, system, null, undefined, true, false)
It is what you type in every team command. The name players see can be a different display name, set on the team's profile

Team size and members

Team size is 2 to 20: how many players a full roster has. It decides which format the team plays (two teams of 5 make a 5v5) and which team queues it can join
Members are optional when you create the team, and creating it with more members than the team size is refused
A player can be on one team of each size: a 5-player team and a 3-player team, but not two 5-player teams. Adding someone who is already on a team of that size is refused

Rosters & Captains

Every /team_admin subcommand that names a team suggests team IDs as you type. Adding and removing players, setting the captain and deleting the team can also be done on the team's page in the dashboard. Changing a team's size takes /team_admin modify.

Command	What it does
/team_admin add_member	Adds one player to a team.
/team_admin remove_member	Removes one player from a team.
/team_admin modify	`members` replaces the whole roster with the players you mention; leave it out to keep the roster as it is. `team_size` changes the size.
/team_admin set_captain	Makes a player on the roster the team's captain. Leave `captain` out to remove the captain.
/team_admin list	Lists the league's teams, optionally only one `team_size`.
/team_admin delete	Deletes the team, its roster and its profile, after you pick the Yes confirmation. It can't be undone; matches it already played stay in the match history.

What a captain does

Team tournaments: with a captain set, only the captain can register the team; with none, any player on the roster can. See tournament registration.
The team's profile on the web: with a captain set, only the captain (and league managers) can edit it; with none, any teammate can.

A team doesn't need a captain. Most small leagues never set one, and everything above works without it.

Team Ratings

A named team's rating

Moves when the team plays as a team: /record_match team_alias, a team queue set to rate the teams, or a tournament entered by named teams. It is kept three ways:

Overall: every match the team plays
By team size: every match where all teams were that size
By format: one exact format, such as 5v5 or 5v5v5

On a team-rated match the players' own ratings don't move: the result belongs to the team.

Automatic team ratings

Any match where every side has the same number of players, two or more, also rates each side as a group, by team size and by format. A duo that plays 2v2 and 2v2v2 has one "teams of 2" rating and one rating for each format.

There is no overall automatic team rating, so showing one always needs a team_size or a versus. Players' own ratings move as usual.

Showing team ratings

With /leaderboard display_leaderboard. team_size picks the by-size rating and versus the by-format one.

To show	Options
Named teams, overall	rating_type:Team Alias
Named teams of 5	rating_type:Team Alias team_size:5
Named teams in 5v5 only	rating_type:Team Alias versus:5v5
Duos, any format	rating_type:Team team_size:2
Duos in 2v2 only	rating_type:Team versus:2v2

To set an automatic team rating by hand, use /set_rating team with the players' mentions: rating_type:Team Broad (by team size) with a team_size, or Team Specific (exact format) with a versus. How the rating types relate is on Rating Types.

Playing as a Team

Recording a match

/record_match team_alias 1st_place:phoenix 2nd_place:dragons

Type team IDs in finishing order, not @mentions. Up to 23 teams, and every one must already exist
The format comes from each team's size: two teams of 5 record as a 5v5
When the leaderboard has custom stats, the bot asks for them before the match is recorded
leaderboard picks the leaderboard (default: the channel's leaderboard, then the league's default), and multiplier weights the rating change
It undoes like any match, with /record_match undo

Who can run it follows /record_match's permissions, including the per-subcommand limits on the dashboard's Discord → Permissions & Logging page. See the option list.

Team queues

/queue_team headless queue_name:scrims team_size:5

Teams join as a unit: any player on a team of the queue's size presses Join Queue and the whole roster joins
A player who isn't on a team of that size is told to ask an admin to add them
If any teammate holds a role your league blocks from queueing, the whole team is refused
A team that is already in a match can't queue again until it is over
By default every member's own rating moves. Set Rate to The teams in the queue's settings on the dashboard (Competition → Matchmaking) to give the roster one rating instead, the one /team stats shows. It applies to matches that start after you save

Team queues are automatic (headless) queues only. More on queue types in Queues & Lobbies and on the Rate setting.

Tournaments

A tournament can be played by named teams: pick them under Who competes when you create it. The captain registers the team (any roster member when there is no captain), a participant role, when the tournament has one, goes to every member, and the team is rated, not its members. Squads are different: they are teams formed for one tournament, and every member's own rating moves with them. Both are on Tournaments.

Stats & Profiles

/team is open to everyone. Both subcommands take a named team's ID, and suggest them as you type. Automatic team ratings have no team ID, so they show on leaderboards instead.

/team stats

/team stats team_name:phoenix

The roster, rating and rank, matches played, win rate, peak rating, recent matches, a rating chart and a link to the team's page.

team_size or versus: the by-size or by-format rating; leave both out for the overall one
time_period: All Time, Last 30 Days, Last 90 Days, Last 10 Matches or Last 25 Matches
leaderboard: default is the channel's leaderboard, then the league's default

/team compare

/team compare first_team_name:phoenix second_team_name:dragons

Two teams side by side: ratings and ranks, their head-to-head record and streaks, win rates, peaks, a prediction and each team's recent matches. Takes the same team_size, versus and leaderboard options.

Team profiles

A named team's display name, tag (2 to 4 characters), description, logo, banner and colors are edited on the web, on the team's page in the dashboard. In Discord, /profile team team_id:phoenix shows the current profile with a link straight to that page.

League managers can edit any team. Players can edit the teams they are on, or only the captain can when the team has one. A named team's public page is at /l/your-league/your-leaderboard/team/phoenix.

On the Dashboard

Page	What it is for
League → Teams	Every named team in the league. Managers create teams here (New team asks for the team ID and size) and open any team to edit it.
You → My Teams	For players: the teams you are on, each a click from its profile.
A team's page	The profile; for managers also the roster (add and remove players, set the captain) and deleting the team. A roster bigger than the team size, or a player already on another team of that size, is refused.

"Discord has a different roster" on a team's page means its roster was edited on the dashboard before October 17, 2026, when dashboard roster edits did not reach Discord. Press Sync to Discord to make the roster on the page the one Discord uses. A team made on the dashboard before then shows "Discord doesn't know this team yet": pick its size and sync.

Limits & Gotchas

/team stats, /team compare and /record_match team_alias take team IDs, not @mentions.
Team IDs: 2 to 32 characters, no spaces. Team size: 2 to 20. One team of each size per player.
A team-rated match moves the team's rating and leaves the players' own ratings where they were.
Showing an automatic team rating needs team_size or versus; rating_type:Team alone has nothing to show.
A named team keeps its rating through roster changes. An automatic team rating belongs to one exact set of players, so a new line-up starts a new one.
Teams can't be merged, and a team ID can't be changed; the display name on the profile is what you change.
Deleting a team can't be undone. Its past matches stay in the match history.
Team queues are automatic (headless) queues only.

FAQ

What's the difference between a team rating and a player rating?

A player rating follows one person across every team they play on. A team rating follows a group: how well those players do together. Strong players who don't play well together can have a low team rating.

Can a player be on more than one team?

Yes, one named team of each size. They also get an automatic team rating with every group they play with, without limit.

How do I see my duo's rating?

If you are a named team, /team stats team_name:your-team. If not, your duo has an automatic team rating: /leaderboard display_leaderboard rating_type:Team team_size:2.

Why can't /team stats find our team?

It looks up named teams by team ID, so a group that only plays together has nothing to find; ask an admin to create the team. If the team exists, pick its ID from the suggestions, and check the leaderboard option: ratings are kept per leaderboard.

How do I see every team a player is on?

Players see their own on the dashboard under My Teams. Admins can list every team with /team_admin list or on League → Teams.

Can I merge two teams?

No. Delete the other team (or remove its players from it) first, then add them to the team you keep. A player can be on only one team of each size, so adding them while they are still on the other team is refused. The deleted team's past matches stay in the match history.