Mattermost
  • About Mattermost
    • Mattermost overview
      • The Mattermost platform
      • Collaboration workflows addressed by Mattermost
      • About the Mattermost open source project
    • Security overview
      • Security features
      • Security updates
      • Security policies
      • HIPAA compliance*
      • FINRA compliance*
    • Integrations overview
      • Custom Apps
      • API
      • Plugins
      • Bots
      • Custom slash commands
      • Webhooks
      • Source code customizations
    • Subscription overview
      • Mattermost Nonprofit License program
      • Mattermost educational license program
      • Frequently asked questions
    • Self-hosted subscriptions
      • Buy a subscription
      • View subscription information
      • Add more users to a subscription
      • Renew a subscription
    • Cloud subscriptions
      • Purchase a Cloud subscription
      • View subscription details
      • Billing period
      • Failed or late payments
      • Add more users to your subscription
      • Renew your subscription
      • Frequently asked questions
    • Mattermost editions and plans
      • Self-hosted editions
      • Mattermost plans
      • Mattermost Starter
      • Mattermost Professional
      • Mattermost Enterprise
      • Limits
      • Other Mattermost plans
      • Product decisions
    • Corporate directory integration
      • Basic authentication
      • Security features for authentication
      • Active Directory/LDAP authentication
      • Authentication options outside of a private network
      • Future authentication methods
    • Certifications and compliance overview
      • GDPR compliance
      • Accessibility compliance
      • U.S. trade compliance
      • U.S. export compliance overview
      • Frequently asked questions
    • Frequently asked questions (FAQ)
      • General Mattermost questions
      • Community questions
      • Notifications
      • Video, audio, and screen sharing
      • Enterprise questions
      • License questions
      • Integrations
      • Use cases
      • Product questions
      • High trust questions
      • Design decisions
      • Business questions
      • Illicit use
  • Deploy Mattermost
    • Deploy Mattermost for production use
    • Prepare for your Mattermost deployment
      • Preview Mattermost via Docker
      • Administrator tasks
      • Architecture
      • Implement Mattermost
      • Enterprise roll out checklist
      • Welcome email template
    • Install guides
      • Server installation
      • Desktop and Mobile App installation
    • Deployment guide
      • Server deployment
      • Desktop and Mobile App deployment
    • Upgrade Mattermost
      • Prepare to upgrade Mattermost
      • Upgrade Mattermost Server
      • Enterprise install and upgrade
      • Install a license key
      • Release definitions
      • Important upgrade notes
      • Release lifecycle
      • Extended Support Release
      • Downgrade Mattermost Server
      • Version archive
    • Scale Mattermost
      • Scale for Enterprise
      • High Availability cluster
      • Elasticsearch
      • Performance monitoring
      • Mattermost performance alerting guide
    • Troubleshooting guides
      • General troubleshooting
      • Troubleshooting mobile applications
      • MySQL installation troubleshooting
    • Changelogs
      • Mattermost self-hosted
      • Mattermost legacy self-hosted
      • Mattermost Cloud
      • Mobile Apps
      • Desktop Apps
      • Deprecated features
    • Additional server install guides
      • Install on Ubuntu 18.04 LTS
      • Install on RHEL 7
      • Deploy Mattermost on Bitnami
      • AWS Elastic Beanstalk Docker setup
      • Install Mattermost Team Edition in GitLab Helm Chart
      • Open source components
  • Mattermost administration
    • Get started
      • Optimize your workspace
      • Mattermost configuration settings
      • Self-hosted edition and license
      • Cloud subscription, billing, and account
      • Reporting configuration settings
      • User management configuration settings
      • Environment configuration settings
      • Site configuration settings
      • Authentication configuration settings
      • Plugins configuration settings
      • Integrations configuration settings
      • Compliance configuration settings
      • Experimental configuration settings
      • Deprecated configuration settings
      • Environment variables
      • Provisioning workflows
      • Multi-factor authentication
      • Active Directory/LDAP
      • GitLab SSO
      • OpenID SSO
      • Google SSO
      • Office 365 SSO
      • Advanced permissions
      • System Admin roles
      • Manage team and channel members
      • Custom branding tools
      • eDiscovery
      • Compliance monitoring
      • Compliance export
      • Data retention tools
      • Custom terms of service
      • Advanced user management
      • Advanced workspace management
    • Cloud workspace management
      • Mattermost Cloud billing
      • Workspace limits
      • Workspace usage
      • Workspace migration
      • Cloud data residency
    • Self-hosted administration
      • Store configuration in the database
      • Bulk loading data
      • SMTP email setup
      • Email templates
      • Calls deployment
      • Configure CloudFront to host static assets
      • Use an outbound proxy
      • Migration guide
      • Chinese, Japanese, and Korean search
      • Customize Mattermost
      • Audit log v2
      • SSL client certificate setup
      • Certificate-based authentication
    • Other resources
      • Convert OAuth 2.0 providers to OpenID Connect
      • Generate a support packet
      • mmctl command line tool
      • Migration announcement email template
      • Advanced permissions infrastructure
      • Command line tools
  • Welcome to Mattermost
    • Access your Mattermost workspace
      • Log in to Mattermost
      • Keyboard shortcuts
      • Log out of Mattermost
    • Mattermost basics
      • Get started with Mattermost Channels
      • Get started with Mattermost Playbooks
      • Get started with Mattermost Boards
      • Manage custom groups
      • About teams
      • Team settings
      • Team keyboard shortcuts
      • About user roles
      • About insights
    • Customize your Mattermost experience
      • Manage your Mattermost profile
      • Set your status and availability
      • Customize your Mattermost theme
      • Customize your Desktop App experience
      • Manage Desktop App server connections
    • Mattermost interface changes
      • What changed in Mattermost v7.0?
      • What changed in Mattermost v6.0?
      • What changed in Mattermost Boards
  • Mattermost Channels
    • Channels, messages, and conversations
    • Work with channels
      • Channel types
      • Create channels
      • Channel naming conventions
      • Rename a channel
      • Convert public channels to private
      • Join and leave channels
      • Start a call
      • Manage channel members
      • Find channels
      • Navigate between channels
      • Mark channels as favorites
      • Customize your channel sidebar
      • Archive and unarchive channels
      • Set channel preferences
      • Channels settings
    • Work with messages
      • Send messages
      • Reply to messages
      • Organize conversations
      • React to messages using emojis
      • Mention people
      • Mark messages as unread
      • Format messages
      • Share files in messages
      • Forward messages
      • Share links to messages
      • Save and pin messages
      • Search for messages
    • Keyboard accessibility
      • Keyboard accessibility in Channels
      • Keyboard shortcuts for Channels
      • Run slash commands
    • Extend Channels functionality
      • Extend functionality with integrations
  • Mattermost Playbooks
    • Overview
      • What’s a playbook?
      • What’s a run?
    • Customize a playbook
      • Edit a playbook
      • Make checklists
      • Assign tasks and due dates
      • Broadcast channels
      • Keywords
      • Actions
      • Run metrics
      • Webhooks
    • Notifications and updates
      • Status updates
      • Follow runs and playbooks
      • Daily digest
      • Playbook to do
    • Metrics and goals
      • Configure retrospectives before a run
      • Metrics
    • Permissions
      • Playbook roles
      • Playbooks permissions
      • Restrict who can create playbooks
    • Reuse and share playbooks
      • Channel export
    • Interact with playbooks
      • Slash commands
      • API documentation
  • Mattermost Boards
    • Overview
      • What’s a board?
      • What’s a card?
      • Access your boards
      • Focalboard personal server
    • Work with boards
      • Adding new boards
      • Choose a board template
      • Edit board templates
    • Work with cards
      • Card descriptions
      • Card properties
      • Add properties
      • Rename a property
      • Change a property type
      • Delete a property
      • Define a “Select” or “Multi-select” property
      • Toggle properties shown on a board
      • Card badges
      • Comment on a card
      • Mention people
      • Receive updates
      • Search cards
      • Card templates
    • Work with views
      • Board view
      • Table view
      • Gallery view
      • Calendar view
    • Work with groups, filter, and sort
      • Group cards
      • Filters
      • Sorting cards
    • Work with calculations
    • Share and collaborate
      • Board permissions
      • Roles
      • Share a board
      • Share cards on Channels
    • Navigate boards
      • Link a board to a channel
      • Unlink a board from a channel
      • Sidebar categories
      • Manage boards on the sidebar
      • Find a board
      • Team sidebar
      • Set language
      • Emoji icons
      • Product tour
    • Migrate to boards
      • Import from Asana
      • Import from Notion
      • Import from Jira
      • Import from Trello
      • Import from Todoist
      • Import and export a board
  • Mattermost for developers
  • Get help with Mattermost
  • Community chat
  • Mattermost Handbook
Mattermost
  • Docs »
  • Mattermost Boards »
  • Navigate boards
  • Search
    Edit

Navigate boards 

plans-img Available on all plans

deployment-img Cloud and self-hosted deployments

If you’ve already created a board, you can open Boards using the App Bar. If you don’t see the Apps Bar to the right of your screen, you can access boards using the product menu in the top left corner of Mattermost.

Link a board to a channel 

From Mattermost Boards v7.2, boards can be linked to channels and accessed from the channel Apps Bar. Select the Boards icon from the Apps Bar in a channel to open a right-hand sidebar (RHS) where channel members can search for and link boards to the channel. To link a board to the channel, select Add button to open the link boards dialog and search for a board to link. Channel members can only search and link boards within the team where they are also board admins.

Note

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.

Open the boards App Bar icon, and select Create a Board to create a new board linked to the current channel. Once a board is linked to a channel, it’s listed in the RHS of the Boards Apps Bar. Linking a board to a channel automatically grants all channel members access to the board. Select a linked board to navigate directly to the board.

Note

For users upgrading to Mattermost Boards v7.2 or later. To maintain the same organization, all the boards previously associated with the workspace will automatically appear on the RHS post-migration.

Unlink a board from a channel 

If you’re a board admin and want to unlink a board from a channel you’re in, open the Boards Apps Bar, select the options menu (…) and select Unlink. Alternatively, you can open the Share dialog on the board, open the Role drop-down menu next to the channel’s name and select Unlink.

Sidebar categories 

From Mattermost Boards v7.2, you can organize your boards on the left hand sidebar using custom categories. By default, all boards will appear under the Boards category.

To manage your categories, open the options menu (…) next to the category to create, delete, or rename a category. With the exception to the default Boards category, all other categories can be renamed or deleted.

After creating categories, you can move your boards to those categories by opening the options menu (…) next to the board and selecting Move To… to select the category where you want the board to be moved.

If you delete a category with boards in it, then those boards will return to the default Boards category.

Categories are organized per-user, so you can arrange your boards under categories that make sense to you without impacting boards or categories for other users. If a board is moved to a custom category, then the board will appear under that category for you only. Other users who are members of the board will continue to see the board in their own categories.

Note

For users upgrading to Mattermost Boards v7.2 onwards:If you belonged to a workspace prior to v7.2, then you’ll see that the workspaces have 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 have default categories, 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.

Manage boards on the sidebar 

In addition to moving boards to other categories, from the options menu (…) next to each board name you can perform the following actions:

  • Delete board: If you are an admin of the board, you will see an option to delete the board. Deleting the board permanently removes the board from the sidebar of all board members.

  • Duplicate board: Creates a copy of the board and all the cards on the board. The duplicated board will appear under the same category as the original board. Board members from the original board are not migrated to the new board.

  • New template from board: Creates a custom board template of the board and all the cards on the board.

  • Hide board: Hides the board from your sidebar only. The board will still remain visible on the sidebar for other board members. You can add the board back to your sidebar using the search box (CMD+K/CTRL+K).

Find a board 

From the top of the boards left hand sidebar, select the Find Boards field (CMD+K/CTRL+K) to open the board switcher, and start typing the name of the board you’re looking for.

Team sidebar 

If you’re a member of multiple teams, the team sidebar will appear on the left hand side of Boards. To switch teams, select any of the team icons from the team sidebar.

Set language 

To set your language on boards, select the gear icon next to your profile avatar, then go to Set language to apply your language settings. Please note: language settings in Boards are independent from language settings in Channels.

Emoji icons 

To enable or disable random emoji icons for your board and cards, select the gear icon next to your profile avatar, then toggle Random icons on or off.

Product tour 

If you skipped the product tour or want a refresher on Boards, you can restart the product tour by going to the gear icon next to your profile avatar and selecting Product tour. This will add a new Welcome to Boards template to your sidebar and kick-off the guided onboarding tour.

Next Previous

© Copyright 2015-2022 Mattermost.

Built with Sphinx using a theme provided by Read the Docs.
  Options 
Contribute
Report a Problem
Edit on GitHub
×
Join us for Hacktoberfest 2022!
Mattermost Logo
  • Platform
    Channels Learn More
    Playbooks Learn More
    Boards Learn More
    • Product Overview
    • Integrations
    • Security
  • Solutions
    Solutions Overview Read More

    USE CASES

    • Secure Collaboration
    • DevOps
    • Workflow Orchestration
    • Incident Resolution
    • CI/CD
    • Test/QA
    • IT Service Desk
    • APM/NPM
    Solutions Overview »

    INDUSTRIES

    • Government
    • Financial Services
    • Media & Entertainment
    • Legal
    • Healthcare
  • Pricing
  • Developers
    Deploy Run Your Server Now
    Integrate Learn More
    Contribute Learn More
    • Blog
    • Resources
    • Community
    • Docs
    • API Reference
    • Release Notes
  • Customers
  • Login
    My Workspace Login
    My Account Login
    Apps Download
    Support Help Center
  • Free Trial
  • Contact Sales