> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tournamentsystem.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Team roles and channels

> How the bot gives every verified team its own Discord role and private text and voice channels, and keeps them in step with the website.

MelCat Interactive sets this up with you once. After that, the bot looks after team roles and channels by itself: you don't hand out team roles or make team channels.

## What each team gets

| | |
| :- | :- |
| Team role | The team's name and colour, shown separately in the member list, with no permissions of its own. Team roles sit in alphabetical order, directly over the captains role in the role list. |
| Text channel | The team's name in lower case, with hyphens for spaces, in the team text category. |
| Voice channel | The team's name, in the team voice category. |
| Who sees the channels | Members with the team role, the staff roles chosen in `/settings` and the bot. Everyone else is hidden. Permissions staff add to a team channel by hand stay. |
| Who holds the role | Every player on the team on the website who is in your Discord server. |

Only verified teams get a role and channels. Team channels are kept in alphabetical order in their categories.

## Keeping in step with the website

A player who joins or leaves a team on the website gets or loses the role within a few seconds. A team role given out by hand is taken back, so change teams on the website, not in Discord.

To change which staff roles see every team's channels, run `/settings`. A staff role you take out stays on existing team channels until you remove it from them; new channels don't get it.

## Team announcements

When you pick a **Team announcements channel** in `/settings`, the bot posts there when a player joins or leaves a verified team, when a team is verified, and when a verified team is disbanded. Players are shown by their name on the website, and nobody is pinged. Nothing is posted when a team stops being verified. A player who is removed or banned is announced as having left.

To change the messages, run `/settings` and select **Edit announcement wording**. Each message's title shows where `{player}` and `{team}` go; they're filled in with the player's and the team's names, and a message must keep them. Leave a message empty to go back to the original wording.

## When a team stops being verified or is disbanded

The bot never deletes a team channel.

A team that isn't verified keeps its role and channels, but nobody holds the role, so only staff see its channels. When you verify the team again, its players get the role back and the chat is as they left it.

When a team is disbanded, its role is deleted and its channels are renamed with `archived-` in front. Only staff see them. The bot stops looking after them, so keep, move or delete them yourself. A new team with the same name gets new channels and can't see the old ones.

When more than three teams are disbanded at once, for example with **Disband all teams** in Settings, the bot waits. Run `/team-sync`: only you see what it would archive. Select **Apply** to archive them.

## Next steps

> [card] [Review and verify teams](https://docs.tournamentsystem.xyz/season/verify-teams.md)
>
> Only verified teams get a role and channels.

> [card] [Discord bot commands](https://docs.tournamentsystem.xyz/discord/bot-commands.md)
>
> What each command does, and turning the bot off.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.