Organize using teams
import useBaseUrl from '@docusaurus/useBaseUrl';
A team is a digital workspace where you and your teammates can collaborate in Mattermost. Depending on how Mattermost is set up in your organization, you can belong to one team or multiple teams, and access to the team can be open or restricted.
Users with the Create Teams permission can create new teams and manage team settings for existing teams. System admins can grant the Create Team permission to roles via the System scheme or the Team override scheme.
Team structure¶
Mattermost can be deployed to a single team or to multiple teams. Many organizations run on a single team and use channels to organize everything within it, while others create a team per business unit, per security boundary, or for collaboration with people outside the organization.
Features including search, saved posts, and recent mentions work across all the teams you belong to.
How many teams your organization has is a decision your system admin makes. See the workspace organization documentation for guidance and to understand the trade-offs behind each approach.
Team sidebar¶
If you belong to more than one team, a team sidebar displays to the left of the channel sidebar. Drag teams to reorder them in the sidebar. You can also use keyboard shortcuts to navigate between teams.
Create a team¶
You can create a team using a web browser or the desktop app by selecting a team name, and then selecting Create a Team, unless your system admin has disabled your ability to do so.
Team name and URL selection¶
There are a few details and restrictions to consider when selecting a team name and team URL.
If your system admin has enabled anonymous team and channel URLs (available in Mattermost Enterprise Advanced from v11.6.0), team creation becomes a single-step flow and you will not be prompted to choose a team URL. The URL is assigned automatically.
Team name¶
This is the display name of your team that appears in menus and headings.
- Team names can contain any letters, numbers, or symbols.
- Team names are case sensitive.
- Team names must be 2 - 64 characters in length.
Team URL¶
If your system admin has not enabled anonymous URLs, you choose a team URL during team creation. The team URL is part of the web address that navigates to your team on the system domain, https://domain.com/teamurl/.
- Teams may contain only lowercase letters, numbers, and dashes.
- Teams must start with a letter and cannot end in a dash.
- Teams must be 2 - 64 characters in length.
- Team names cannot start with the following restricted words:
admin,api,channel,claim,error,files,help,landing,login,mfa,oauth,plug,plugins,post,signup, orplaybooks.
Join a team¶
You can join any open teams, or join any team you receive an invitation to join.
If you haven't yet joined any teams in Mattermost, you're prompted to join available teams when you log in to Mattermost.
You can be a member of multiple teams at the same time. To join additional teams, select the current team name, choose Join Another Team, and select the name of the team you want to join.
When your organization uses team membership access policies, the list of teams you can join depends on your user attributes. Public teams whose requirements you meet are marked Recommended, and private teams whose requirements you don't meet aren't listed at all.
From Mattermost Mobile v2.40.0, you can join another team from the mobile app by tapping the team name in the channel list header, then tapping Join Another Team.
Leave a team¶
Users can also choose to remove themselves from a team, from Team menu > Leave Team. This will remove the user from the team, and from all public channels and private channels on the team.
From Mattermost Mobile v2.40.0, you can leave a team from the mobile app when you belong to more than one team. In the channel list, tap the team name, tap Leave team, then confirm.
They will only be able to rejoin the team if it's open, or if they receive a new invitation. If they do rejoin, they will no longer be a part of their old channels.
Remove people from teams¶
Team admins can remove users from a team via Team menu > Manage Members > Remove From Team in the dropdown menu beside a user entry.
When a user is removed from a team, the team will no longer be visible or accessible in their team sidebar. If they currently have the team open, they are redirected to the first team that appears in their team sidebar. If they didn't belong to any other teams, the user is sent to the team selection page.
Removing a user from the team does not deactivate the account. The user will still be able to log in to the site, and join other teams. They will also be able to rejoin the team they were removed from if they receive another invite. When a private team has a team membership access policy, invited users must also satisfy that policy. Users can also rejoin if the team is set to Public Team and they meet any other join restrictions, such as approved email domains. Team membership access policies on public teams are advisory and don't prevent users from rejoining. If the user does rejoin the team, they will no longer belong to the channels they were previously a part of, and they will lose all Admin privileges if they had them previously.
A system admin can also remove users from teams via System Console > Users, and selecting the dropdown beside a user entry and selecting Manage Teams. The list of teams an individual user belongs to can be viewed on the user's profile page via System Console > Users and selecting the member's name from the list provided in the User Configuration screen.
Archive a team¶
A Mattermost system admin can archive teams they no longer need by going to System Console > Teams, selecting a team, and selecting Archive Team. Archived teams can be unarchived if needed.
When a team is archived, the team will no longer be visible or accessible in the team sidebar for any user. If users currently have the team open when it's being archived, users are redirected to the first time that appears in their team sidebar. If users didn't belong to any other teams, users are sent to the team selection page.
Archiving a team doesn't remove the team data from the Mattermost database. Teams may still be accessible by using the Mattermost API.