Work with boards#

plans-img Available on Enterprise plans

deployment-img Cloud and self-hosted deployments

Start by selecting the type of board you want to use. A board contains cards, which typically track tasks or topics, and views, which define how to display the cards, or a subset of them. Views can display cards in a board, table, calendar, or gallery layout, optionally filtered and grouped by a property (e.g., priority, status, etc).

Add new boards#

To add a new board, select the plus icon The Plus icon provides access to channel and direct message functionality. at the top of the sidebar, then select Create New Board to open the template picker and select a template or blank board.

Board details#

To name or rename a board, select the title area to edit it.

To display board description, hover above the board’s title and select Show description to activate the show/hide toggle. Once the description field is displayed, select Add a description right below the board title to add or edit the description.

Boards and cards are created with random icons by default. To change or remove icons, select the icon then choose the appropriate action.

All changes you make to boards and cards are saved immediately.

Choose a board template#

Templates provide you with a predefined structure so that you can get started quickly. Each template has a different function, but can be customized to suit your use case. When you create a new board from the template picker, select each template’s name to preview it and make sure it suits your requirements. Alternatively, you can create your own board templates.

Board templates#

Standard board templates include:

  • Content Calendar: Plan and organize your content creation and publication schedule.

  • Company Goals & OKRs: Plan your company goals and objectives more efficiently.

  • Competitive Analysis: Track and stay ahead of the competition.

  • Meeting Agenda: Use this template for recurring meetings. Queue up items, organize discussions, and plan what to revisit later.

  • Personal Goals: Categorize and plan your personal goals.

  • Personal Tasks: Organize your life and track your personal tasks.

  • Project Tasks: Stay on top of your project tasks, track progress, and set priorities.

  • Roadmap: Plan your roadmap and manage your releases more efficiently.

  • Sprint Planner: Plan your sprints and releases more efficiently.

  • Team Retrospective: Identify what worked well and what can be improved for the future.

  • User Research Sessions: Manage and keep track of all your user research sessions.

  • Welcome to Boards!: Onboarding template with guided tour points to help you quickly ramp up on Boards.

Create a blank board#

If none of the available templates suit your requirements, you can create a blank board using the Create empty board option from the template picker.

Create a new template#

To create a new board template select the plus icon The Plus icon provides access to channel and direct message functionality. at the top of the sidebar to open the template picker, select Create New Board and then select + New template.

To turn an existing board into a template, hover over the board title in the sidebar. Select the options menu Use the More icon to access additional message options., then select New template from board.

Share a custom board template#

Custom templates support permissions control, and are restricted to only the template creator by default. The template creator is an admin of the template. To make the template accessible to everyone on the team, select Share on the template editor, and then set the team role as Viewer. All members of the team will now be able to see and select the template from the template picker.

The admin of the template can also grant specific team members elevated permissions to the template and/or limit access to selected team members by setting the team role as None and adding individual members to the template. Individual team members can be assigned the following roles on a template:

  • Admin: Can modify the template and its permissions, and delete the template.

  • Editor: Can modify but not delete the template, nor change permissions.

  • Viewer: Can view and select the template.

Boards and templates are channel-specific so whichever channel you create your board or template in, is where you’ll find it. If you’d like to re-use a board as a template on another channel workspace, you can export it and then import the archive file in the channel of your choosing.

To do this, select the options menu Use the More icon to access additional message options. in the toolbar at the top of the board. Then select Export board archive. Download the archive file. Navigate to the channel where you’d like to add the exported board. Select the gear icon Use the Settings icon to customize your Mattermost user experience. next to your profile picture, then choose Import archive. The board you created will be added to this channel.

Edit board templates#

Custom templates are fully editable, but standard templates cannot be edited or deleted. To open the template editor for a specific template, go to the template picker then hover over the custom template and select the pencil icon. Any changes made on the template editor will be automatically saved and visible to team members who have access to the template.

Only admins and editors of a custom template can edit the template. If you don’t see the pencil icon when hovering over the template, then you don’t have the appropriate permissions to edit the template.

Any member of the channel workspace can edit a custom template in the channel. To limit access to the template, create or export the template to a private channel.