What’s new in Mattermost Boards
Available on all plans
Cloud and self-hosted deployments
For the latest Boards updates, check out our Mattermost self-hosted changelog and our Mattermost Cloud changelog.
Overview of v7.2 and beyond
All the boards you’re currently a member of from your current team will appear on the sidebar without needing to switch workspaces.
Organize boards on the sidebar with custom categories.
Press Ctrl K on Windows or Linux, press ⌘ K on macOS to find additional boards.
Navigate between teams in Boards with the new team switcher.
Set board and template permissions in the new Share dialog.
Link boards to channels to automatically grant board permissions to channel members.
Linking boards to channels
The channel header’s board icon is now located on the channel Apps Bar. When you select the Boards icon, you’ll open a new right-hand sidebar (RHS) where channel members can search and link boards to the channel. To maintain the same organization, all the boards previously associated with the workspace will automatically appear on the RHS post-migration. Select a linked board to navigate directly to the board.
Channel members can search and link boards within the team where they are also board admins. Linking a board to a channel automatically grants all channel members Editor access to the board.
A channel can be linked to multiple boards, but each individual board can only be linked to one channel at a time. Linking the same board to another channel will automatically remove the link from the previous channel.
Channel members can also create a new board from the RHS. Doing so will automatically link the new board to the channel and grant channel members permissions to the board.
Custom templates also support permissions control, and are restricted to only the template creator by default. The template creator is an admin of the template and can make it public so it will be accessible to everyone on the team via the Share button on the template editor, and then setting the team role as Editor.
Instead of being tied to a particular channel, each board has been automatically migrated to use its own access control list. The creator of the original board is set as an admin on the board, with the ability to change the board’s permissions. Other members are granted the Editor role.
There are schema changes introduced in Boards v7.2. If you have a large database, you may need to allocate additional time and resources to this migration. Please review this document for details around permission migrations.
If a board or custom template was previously attached to a public channel: It’s now searchable by, and accessible to, any member of that channel’s team, including future members.
If a board or custom template was previously attached to a private channel: It’s now searchable by, and accessible to, any member of that channel at the time of migration. Future members will need to be added by the admin.
Direct messages (DMs) and group messages (GMs)
If a board or custom template was previously attached to a direct message or group message: It’s now searchable by, and accessible to, any member of that channel. Future members will need to be added by the admin.
For boards previously attached to DMs and GMs whose members are associated with more than one team:
The board will be moved to the first team on the team sidebar where all the board members are current team members.
In the case where some members do not belong to the same team, we will associate the board to the first team where the creator (board admin) has access and where most other board members are current team members.
These boards may not appear in your search results when switching teams.
Workspaces to categories
If you belonged to a workspace at the time of migration you’ll see that they’ve been migrated to custom categories in the sidebar. All boards from a workspace are listed under a category of the same name. Boards from direct messages and group messages appear under the default Boards category.
Categories are per-user, and can be renamed or deleted by each user after migration. New users won’t see the custom categories created from migration, and boards they join will appear under the default Boards category.
Boards that you create after the migration won’t be linked to a workspace, and will always appear under the default Boards category unless you move or hide the boards.
Frequently asked questions
Do I need to plan for downtime during the migration?
There are schema changes in v7.2. If you have a large database you may need to allocate additional time and resources to this migration. Please review this document for details around permission migrations.
Will I need to backup and restore any data?
The migration will happen automatically, but your administrator should perform a backup prior to the upgrade.
How do I move a board to another category?
Select the … menu next to the board’s name in the sidebar, and select Move To….
What happens if I delete a category with boards underneath it?
The boards will be moved to the default “Boards” category. Other users with the same category name will not be impacted.
How do I create a public custom template?
On the template editor, select Share and set the team role to Editor.
Help, I’ve got a problem not covered here, what do I do?
Please report any issues to the public Focalboard channel or file a bug on GitHub. We’re here to help!