Share and collaborate
Available on all plans
Cloud and self-hosted deployments
Board permissions
From Mattermost Boards v7.2 boards belong to teams, and any member of that team can be granted access to a board.
If your boards workspace looks different, you may be on an earlier version of Boards, where boards are tied to channel workspaces and board membership is determined by channel membership. In this case, roles and permissions won’t be applicable to you.
Roles
Board permissions |
Admin |
Editor |
Commenter |
Viewer |
|---|---|---|---|---|
Modify permissions |
X |
|||
Share a public board |
X |
|||
Delete board |
X |
|||
Rename board |
X |
X |
||
Add, edit, and delete views |
X |
X |
||
Add, edit, and delete cards |
X |
X |
||
Comment, delete my comments |
X |
X |
X |
|
Delete any comment |
X |
|||
View |
X |
X |
X |
X |
The level of access to a board is determined by a user’s assigned board role. Individual board membership always gets precedence, followed by highest (most permissive) group role.
Admin: Can modify the board, its contents, and its permissions. By default, board creators are also admins of the board.
Editor: Can modify the board and its contents.
Commenter: Can add comments to cards.
Viewer: Can view the board and its contents but can’t comment or edit the board.
Manage team access
Board admins can manage team access to their board by selecting Share in the top-right corner of the board. On the dropdown next to Everyone at… Team option, select a minimum board role for everyone on the team. You can also easily assign the new roles to the entire team and/or to individual team members.
Minimum default board roles reduce permission ambiguity and prevent security loopholes. The minimum default role means that board admins can’t assign individual board members a role lower than the team role. If the team role is set to Editor then the board admin will only be able to assign the Editor or Admin role to individual team members. Lower roles will not be available for selection unless the admin changes the minimum board role.
Depending on the role selected, everyone on the team will have access to the board with a minimum of the permissions from the role selected. Users can get elevated permissions based on their individual board membership. The default team access for a newly created board is None, which means nobody on the team has access to the board.
Manage individual board membership
Only board admins can manage user permissions on a board, including adding, changing, and removing members.
To add individual users from the team as explicit members of the board, open the Share dialog on the board, search for individual team members, then assign a role to set their permissions for the board. The role for individual board members overrides any role specified for team access.
To change a board member’s role, open the Share dialog, select the role dropdown next to the user’s name, then select another role from the list.
To remove a member from a board, open the Share dialog, select the role dropdown next to the user’s name, then select Remove member.
Board admins can also add individual members using the autocomplete list from @mentions and the person properties. To add an individual from the autocomplete list, type their username in an @mention or in the Person or Multi-person properties, then assign a role to the user from the confirmation dialog, and select Add to board.
On boards with team access, board members with Editor or Commenter roles can also add individuals to the board from the autocomplete list. Board members added in this manner will be assigned the default minimum board role.
Channel role groups
Board admins can add a channel to a board to grant all its members Editor access. To do this, select Share in the top-right corner of the board, search for the channel name, and add it to the board as a user. The default role is Editor. Doing so also links the board back to the channel, where the board will appear on the channel RHS.
To unlink the channel from the board, open the Share dialog, select the role dropdown next to the channel’s name, then select Unlink.
Note
A board can only be linked to one channel at a time. Linking another channel to the same board will automatically remove the link from the previous channel.
Guest accounts
From Mattermost Boards v7.4, guest accounts will be supported in Boards. Guests can:
Access boards where they’re added as an explicit member of the board. Team access and channel role groups don’t apply to guest accounts.
Access existing boards, but not create new boards. Guests don’t have access to the template picker and can’t duplicate an existing board.
Search for boards where they’re currently an explicit member.
Be assigned the Viewer, Commenter, or Editor roles, but not the board Admin.
Only @mention current members on the board.
Note
If you’re not able to access this functionality, you may be on an earlier version of Boards.
