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 your subscription
      • Quarterly true-up report
      • Renew your subscription
    • Cloud subscriptions
      • Buy a Cloud subscription
      • View subscription information
      • Billing period
      • Failed or late payments
      • Add more users to your Cloud Professional subscription
      • Renew your subscription
      • Frequently asked questions
    • Mattermost editions and plans
      • Self-hosted editions
      • Mattermost plans
      • Mattermost Free
      • 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
      • Notify Admin
      • Advanced user management
      • Advanced workspace management
    • Cloud workspace management
      • Mattermost Cloud billing
      • Workspace limits
      • Workspace usage
      • Workspace migration
      • Cloud data residency
    • Self-hosted administration
      • Mattermost self-hosted billing
      • 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 logging
      • JSON audit log schema
      • SSL client certificate setup
      • Certificate-based authentication
      • Manage telemetry
    • 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
      • Add people to your workspace
      • 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 multiple 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
      • Browse channels
      • Navigate between channels
      • Mark channels as favorites
      • Mark channels as unread
      • Customize your channel sidebar
      • Archive and unarchive channels
      • Set channel preferences
      • Channels settings
      • Interact with channels
    • Work with messages
      • Send messages
      • Set message priority
      • 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?
      • Keywords
      • Welcome message
      • Tasks and checklists
      • Status updates
      • Retrospective
    • Work with playbooks
      • Templates
      • Edit a playbook
      • Make checklists
      • Multiple runs in a channel
      • Status updates
      • Keywords
      • Actions
      • Run metrics
      • Webhooks
    • Work with runs
      • Follow and participate
      • View run details
      • Runs and channel behavior
      • Send outgoing webhooks
    • Work with tasks
      • Tasks and due dates
      • Task inbox
    • Work with notifications and updates
      • Status updates
      • Request an update
      • Follow runs and playbooks
      • Daily digest
      • Playbook to do
    • Work with metrics and goals
      • Configure retrospectives before a run
      • Metrics
    • Share and collaborate
      • Playbook roles
      • Playbooks permissions
      • Restrict who can create playbooks
    • 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
      • Add 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
      • Attach files
      • 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
      • Guest accounts
      • Share a board
      • Share cards on Channels
    • Import, export, and migrate
      • Import and export a board archive
      • Export to CSV
      • Import and export from other applications
      • Import from Asana
      • Import from Notion
      • Import from Jira
      • Import from Trello
      • Import from Todoist
    • Navigate boards
      • Link a board to a channel
      • Unlink a board from a channel
      • Sidebar categories
      • Drag and drop
      • Manage boards on the sidebar
      • Find a board
      • Team sidebar
    • Boards settings
      • Set language
      • Random emoji icons
      • Product tour
  • Mattermost for developers
  • Get help with Mattermost
  • Community chat
  • Mattermost Handbook
  • Contribute to this site
    • How to get started
    • First time contributor?
    • Where to find more information
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 right-hand side of the Boards Apps Bar. Linking a board to a channel automatically grants all channel members access to the board, with the exception of guest accounts. Select a linked board to navigate directly to the board.

Note

If you’re upgrading to Mattermost Boards v7.2 or later, all the boards previously associated with the workspace will automatically appear on the right-hand side panel 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 Access additional message actions using the More actions icon. 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 in the left-hand sidebar using custom categories. By default, all boards will appear under the Boards category. To manage your categories, open the Access additional message actions using the More actions icon. 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 Access additional message actions using the More actions icon. 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

Upgrading to Mattermost Boards v7.2 onwards: If you belonged to a workspace prior to v7.2, 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.

Drag and drop 

You can move both sidebar categories and boards and change the order of both to suit your preference. You can:

  • Set the position of a board within a category.

  • Drag a board out of one category and drop it into another category.

To do this, select and hold the cursor over the category or board name. Then move the category or board around as needed. Boards moved into a category are sorted to the top of the category by default unless you specifically position the board before releasing the cursor.

Manage boards on the sidebar 

In addition to moving boards to other categories, from the Access additional message actions using the More actions icon. menu next to each board name you can perform the following actions:

  • Delete board: If you’re 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 and comments from the original board aren’t 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.

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
×
Learn how to streamline incident response with Mattermost & ServiceNow on February 16th »
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
  • Get Started
  • Contact Sales