Mattermost
  • About Mattermost
    • Mattermost Overview
      • The Mattermost platform
      • Collaboration workflows addressed by Mattermost
        • Use Channels to stay connected and support your communication workflows
        • Use Playbooks to support your prescribed workflows and trust the process
        • Use Boards to hit your milestones and support your project workflows
      • About the Mattermost open source project
    • Security Overview
      • Security Features
        • Private Cloud Deployment with Secure Mobile Apps
        • Centralized Security and Administration
        • Transmission Security
        • Integrity and Audit Controls
        • Authentication Safeguards
        • Access Control Policy
      • Security Updates
      • Security Policies
      • HIPAA compliance*
      • FINRA compliance*
    • Integrations Overview
      • Custom Apps
      • API
      • Plugins
      • Bots
      • Custom Slash Commands
      • Webhooks
      • Interactive Messages
      • CLI
      • Zapier
      • Source Code Customizations
    • Subscription Overview
      • General Frequently Asked Questions
        • Are my credit card details safe?
        • Why do I need to provide my name and physical address when purchasing a subscription?
        • What does Mattermost do with this information?
        • Who are the sanctioned people, companies, and entities?
        • What does “physical address” mean for software that will be used in many places?
        • How is a user defined for subscriptions?
        • Do I need to pay for deactivated users?
        • Which features are affected when my subscription expires?
        • Do you have a program for official non-profits, open source projects, and charities?
        • Do you have discounted subscriptions for academic institutions?
        • Is there a maximum number of users per subscription?
        • What happens if my department buys a Mattermost subscription and then central IT buys a high volume subscription that also covers my department?
    • Self-Hosted Subscriptions
      • Purchase a subscription
      • View subscription information
      • Add more users to a subscription
      • Renew a subscription
        • Frequently Asked Questions
    • Cloud Subscriptions
      • Purchase a Cloud subscription
      • View subscription details
      • Add more users to your subscription
      • Renew your subscription
      • Frequently Asked Questions
        • How am I billed for my Cloud monthly subscription?
        • Can I purchase an annual subscription to Mattermost Cloud deployments?
        • How do I cancel my subscription?
        • When will support for other regions be available?
        • How is Mattermost Cloud secured?
        • What are the alternatives, and why should customers choose Mattermost Cloud?
        • Is Mattermost Cloud Enterprise a dedicated instance run on AWS systems?
        • How is customer data in Mattermost Cloud Enterprise encrypted?
        • Are S3-managed keys used for server-side encryption?
    • Mattermost Deployments and Editions
      • Mattermost deployment options
        • Mattermost self-hosted
        • Mattermost Cloud
      • Mattermost editions
        • Mattermost Team Edition
        • Mattermost Starter
        • Mattermost Professional
        • Mattermost Enterprise
      • Mattermost legacy Enterprise Editions
        • Mattermost Enterprise Edition E10
        • Mattermost Enterprise Edition E20
      • Packaging 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
        • Continual Commitment to the Principles of GDPR
        • Security Infrastructure
        • Contractual Obligations
        • Privacy Measures
        • Product Features
      • Accessibility Compliance
      • U.S. Trade Compliance
        • What is the process to end a customer relationship due to new U.S. sanctions?
      • U.S. Export Compliance Overview
        • Summary Table
        • Overview
        • General Information
        • Export Classification and Licensing
        • Disclaimer
      • Frequently Asked Questions
        • To be compliant with GDPR, do I need to remove message contents of email notifications?
        • What information is shared when I click Contact us on a Mattermost Admin Advisor notification?
        • Are the server access logs containing IP addresses a GDPR compliance issue?
        • Do you have Fed or Department of Defense (DOD) Certification?
        • How do you ensure personal data stays within European Union?
    • Frequently Asked Questions (FAQ)
      • General Mattermost Questions
        • Why was Mattermost created?
        • Why does the open source repository contain code specific to the commercial version of Mattermost?
        • Does Mattermost support 508 Compliance?
        • What’s the largest Mattermost deployment you have?
        • How do I deploy the open source Mattermost Team Edition under an MIT license?
      • Community Questions
        • How can I contribute to Mattermost?
        • Can contributors add themselves to the Mattermost company page on LinkedIn?
      • Notifications
        • What determines if a desktop notification should be triggered?
        • What determines if an email notification should be triggered?
        • What determines if a mobile push notification should be triggered?
        • Are mobile push notifications free?
      • Video, Audio, and Screen Sharing
        • What support is available for video and audio calling and screen sharing?
      • Enterprise Questions
        • What is Mattermost Enterprise Edition?
        • How can I be assured that my data will not be locked in to commercial software?
        • How does Mattermost scale from teams to enterprises?
        • What does it take to manage a Mattermost deployment?
        • How do you manage multiple messaging solutions in an enterprise?
        • What are the options to purchase a subscription to Mattermost Enterprise Edition?
        • What happens when the Enterprise Edition subscription expires?
        • What are Mattermost’s policies around licensing, terms of use, and privacy?
        • How does the licensing key work?
        • Do you have a program for official non-profits and charities?
        • Do you have discounted licenses for academic institutions?
      • Mattermost Source Available License
        • What is the Mattermost Source Available License?
        • How can I identify code licensed as source available?
        • Why are you changing the licensing model?
        • How are repositories changing?
        • To which repositories does this apply?
        • Will the repositories be public?
        • Can I still contribute?
        • Do I need to re-sign the Mattermost CLA?
        • Can I compile your plugins by myself?
        • Will you distribute open source plugin binaries without any licensing restrictions?
        • Can I continue to use the existing open source repositories without restriction?
        • Do I need to use the Mattermost Source Available License for plugins I create?
        • Can I publish my own plugin and rely on enterprise specific functionality?
        • Can’t someone compile out any license restrictions?
        • If I make my own plugin using your source available code, can I remove the license restriction?
        • Will you pursue legal action if this license is violated?
        • Is this a legal document?
        • What is the full text of the Mattermost Source Available License?
      • Integrations
        • Can I use Mattermost to add messaging functionality to my proprietary SaaS service?
      • Use Cases
        • Does Mattermost support external guests?
        • Can I use Mattermost for customer service?
        • Does Mattermost have an official website-based plugin to offer anonymous chat to visitors?
      • Product Questions
        • What features are available on different Mattermost clients?
        • What feature quality levels does Mattermost have?
      • High Trust Questions
        • What are the trust benefits of Mattermost compared to third-party SaaS systems that let customers manage their own encryption keys?
        • What are the fundamental security challenges with Massive, Multi-Tenant Applications (MMTA)?
      • Design Decisions
        • Why does Mattermost disclose whether or not an account exists when a user enters an incorrect password?
      • Business Questions
        • How can I create an open source derivative work of Mattermost?
        • Will Mattermost complete questionnaires requiring confidential data without an NDA?
        • Why does Mattermost have a discount for certain kinds of non-profits but not for others?
        • Can I create a derivative work of the Mattermost /mattermost-server repository that is not open source?
        • Will Mattermost, Inc. offer the ability to resell Mattermost software without a reseller agreement?
        • Does Mattermost answer questions about open source licenses authored by other organizations?
      • Illicit Use
        • How do I report illicit use of Mattermost software?
  • Deploy Mattermost
    • Get Started
      • Quick Install Guide
        • Installation
        • Add Users
        • Create a Notifications Hub
      • Run Mattermost via Docker
        • One-line Docker install
        • Configuration Settings
        • Updating Mattermost Preview
        • Accessing Your Container
      • Administrator Tasks
        • Getting Started Tasks
        • Important Administration Notes
        • Common Tasks
        • User Experience Optimizations
      • Architecture
        • Basics
        • High Availability and Scalability
        • Reference Architectures
      • Implement Mattermost
        • 1 Introduction
        • 2 System Overview
        • 3 Management Overview
        • 4 Implementation Support
      • Enterprise Roll Out Checklist
        • Checklist Overview
        • Checklist Details
      • Welcome Email Template
        • Email Template
    • Install Guides
      • Server Installation
        • Software and Hardware Requirements
        • Local Docker Setup
        • Mattermost Omnibus
        • Ubuntu 20.04 LTS
        • Kubernetes
        • Debian Buster
        • RHEL 8
        • CentOS, Oracle Linux, and Scientific Linux
      • Desktop/Mobile App Installation
        • Install the Mattermost Desktop App
        • Desktop Application Install Guides
        • iOS Setup
        • Android Setup
        • Testing Push Notifications
    • Deployment Guide
      • Server Deployment
        • Deployment Overview
        • Set Up a Socket-based Mattermost Database
        • Image Proxy
        • Backup and Disaster Recovery
        • Encryption Options
        • Configure Transport Encryption
        • Bleve Search
      • Desktop & Mobile App Deployment
        • Desktop App Deployment Guide
        • Desktop MSI Installer and Group Policy Installation Guides (Beta)
        • Desktop App Custom Dictionaries
        • Desktop Managed Resources
        • Using Mattermost’s Pre-Built Mobile Apps
        • Deploy Mattermost Mobile Apps
        • Mobile Push Notifications
        • Building and Distributing Your Own Custom Mattermost Mobile Apps
        • Deploying Mobile Apps Using an EMM Provider
        • AppConfig for EMM Solutions with Mattermost Mobile Apps
        • Mobile VPN Options
        • Mobile Apps FAQ
        • Client-side Data Storage FAQ
    • Upgrade Mattermost
      • Upgrade Mattermost Server
        • Preparing to upgrade to the latest version
        • v6.0 database schema migrations
        • Upgrading from releases older than v5.35
        • Upgrading High Availability deployments
        • Before you begin
        • Upgrading Mattermost Server
        • Upgrading Team Edition to Enterprise Edition
        • Uploading a license key
      • Enterprise Install and Upgrade
        • Installing Enterprise Edition
        • Upgrading to Mattermost Enterprise Edition
        • Converting Team Edition to Enterprise Edition
      • Install a License Key
        • Changing an existing license key
        • License key storage
      • Release Definitions
        • Feature Release
        • Quality Release
        • Extended Support Release (ESR)
      • Important Upgrade Notes
      • Release Lifecycle
        • What is a Release Lifecycle?
        • Desktop and Mobile App Server Compatibility
        • Notes on Upgrading to Mattermost v6.0
      • Extended Support Release
        • What is an Extended Support Release?
        • What is the life cycle of an Extended Support Release?
        • What is included in an Extended Support Release dot release?
        • Who should use an Extended Support Release?
        • How do I install the Extended Support Release?
        • What are the current supported Extended Support Release versions?
        • How do I restore a previous Extended Support Release?
        • Why is an Extended Support Release supported for nine months and not longer?
        • Can customers pay for extended support?
        • How do we notify customers about new and deprecated Extended Support Releases?
      • Downgrade Mattermost Server
        • Downgrading from v6.0 to v5.38
      • Version Archive
        • Mattermost Enterprise Edition
        • Mattermost Team Edition
    • Scale Mattermost
      • Scale for Enterprise
        • Single Machine Deployment
        • Multi Machine Deployment
        • Cluster-based Deployment
        • Sample Scaling Guide
        • Hosting Recommendation for 100,000+ users
      • High Availability Cluster
        • Requirements for Continuous Operation
        • Deployment Guide
        • Configuration and Compatibility
        • Upgrade Guide
        • Frequently Asked Questions (FAQ)
        • Troubleshooting
      • Elasticsearch
        • Deployment Guide
        • Limitations
        • Frequently Asked Questions (FAQ)
      • Performance Monitoring
        • Deployment Guide
        • Installing Prometheus
        • Installing Grafana
        • Getting Started
        • Statistics
        • Frequently Asked Questions
      • Mattermost Performance Alerting Guide
        • CPU Utilization Rate
        • Memory Usage
        • Number of Goroutines
        • Number of API Errors per Second
        • Mean API Request Time
        • Plugin Hooks
        • Other Alerts
    • Troubleshooting Guides
      • General Troubleshooting
        • Important Notes
        • General Troubleshooting
        • Connect to Another Server
        • Connect with Another Device
        • Opening a Support Ticket for Self-Hosted Deployments
        • Appendix
      • Troubleshooting Mobile Applications
        • I keep getting a message “Cannot connect to the server. Please check your server URL and internet connection.”
        • Login with ADFS/Office365 is not working
        • I see a “Connecting…” bar that does not go away
        • I’m not receiving push notifications on my device
        • All my outbound connections need to go through a proxy. How can I connect to the Mattermost Hosted Push Notification Service?
        • Build gets stuck at bundleReleaseJsAndAssets
        • No image previews available in the mobile app
        • Messages with emojis aren’t being sent from the Mobile App
        • None of these solve my problem!
      • MySQL Installation Troubleshooting
        • The mattermost Database
        • The Database User
        • The User Password
        • Insufficient User Privileges
    • Changelogs
      • Mattermost Self-Hosted
        • Release v6.5 - Feature Release
        • Release v6.4 - Feature Release
        • Release v6.3 - Extended Support Release
        • Release v6.2 - Feature Release
        • Release v6.1 - Feature Release
        • Release v6.0 - Feature Release
        • Release v5.39 - Quality Release
        • Release v5.38 - Feature Release
        • Release v5.37 - Extended Support Release
      • Mattermost Legacy Self-Hosted
        • Latest Mattermost releases
        • Release v5.36 - Feature Release
        • Release v5.35 - Feature Release
        • Release v5.34 - Feature Release
        • Release v5.33 - Feature Release
        • Release v5.32 - Feature Release
        • Release v5.31 - ESR
        • Release v5.30 - Feature Release
        • Release v5.29 - Quality Release
        • Release v5.28 - Feature Release
        • Release v5.27 - Quality Release
        • Release v5.26 - Feature Release
        • Release v5.25 - ESR
        • Release v5.24 - Feature Release
        • Release v5.23 - Quality Release
        • Release v5.22 - Feature Release
        • Release v5.21 - Quality Release
        • Release v5.20 - Feature Release
        • Release v5.19 - ESR
        • Release v5.18 - Feature Release
        • Release v5.17 - Quality Release
        • Release v5.16 - Feature Release
        • Release v5.15 - Quality Release
        • Release v5.14 - Feature Release
        • Release v5.13 - Quality Release
        • Release v5.12 - Feature Release
        • Release v5.11 - Quality Release
        • Release v5.10 - Feature Release
        • Release v5.9 - ESR
        • Release v5.8 - Feature Release
        • Release v5.7 - Quality Release
        • Release v5.6 - Feature Release
        • Release v5.5 - Quality Release
        • Release v5.4 - Feature Release
        • Release v5.3 - Feature Release
        • Release v5.2 - Feature Release
        • Release v5.1 - Feature Release
        • Release v5.0 - Feature Release
        • Release v4.10 - ESR
        • Release v4.9 - Feature Release
        • Release v4.8 - Feature Release
        • Release v4.7 - Feature Release
        • Release v4.6 - Feature Release
        • Release v4.5 - Feature Release
        • Release v4.4.5 - Feature Release
        • Release v4.3.4 - Feature Release
        • Release v4.2.2 - Feature Release
        • Release v4.1.2 - Feature Release
        • Release v4.0.5 - Feature Release
        • Release v3.10.3
        • Release v3.9.2
        • Release v3.8.3
        • Release v3.7.5
        • Release v3.6.7
        • Release v3.5.1
        • Release v3.4.0
        • Release v3.3.0
        • Release v3.2.0
        • Release v3.1.0
        • Release v3.0.3
        • Release v2.2.0
        • Release v2.1.0
        • Release v2.0.0
        • Release v1.4.0
        • Release v1.3.0
        • Release v1.2.1
        • Release v1.2.0 (Redacted Release)
        • Release v1.1.1 (Quality Release)
        • Release v1.1.0
        • Release v1.0.0
        • Release v0.7.0 (Beta1)
        • Release v0.6.0 (Alpha)
        • Release v0.5.0 (Preview)
      • Mattermost Cloud
        • Release 2022-03-08
        • Release 2022-03-02
        • Release 2022-02-16
        • Release 2022-02-10
        • Release 2022-02-03
        • Release 2022-01-27
        • Release 2022-01-25
        • Release 2022-01-11
        • Release 2021-12-08
        • Release 2021-12-01
        • Release 2021-11-23
        • Release 2021-11-11
        • Release 2021-11-10
        • Release 2021-10-27
        • Release 2021-10-13
        • Release 2021-09-29
        • Release 2021-08-12
        • Release 2021-07-29
        • Release 2021-07-15
        • Release 2021-07-01
        • Release 2021-06-16
        • Release 2021-06-02
        • Release 2021-05-21
        • Release 2021-05-05
        • Release 2021-04-22
        • Release 2021-04-07
        • Release 2021-03-24
        • Release 2021-03-12
        • Release 2021-02-25
        • Release 2021-02-10
        • Release 2021-01-26
        • Release 2021-01-12
        • Release 2020-12-18
        • Release 2020-12-09
        • Release 2020-12-03
        • Release 2020-11-24
      • Mobile Apps
        • 1.50.0 Release
        • 1.49.1 Release
        • 1.49.0 Release
        • 1.48.2 Release
        • 1.48.1 Release
        • 1.48.0 Release
        • 1.47.2 Release
        • 1.47.1 Release
        • 1.47.0 Release
        • 1.46.0 Release
        • 1.45.1 Release
        • 1.45.0 Release
        • 1.44.1 Release
        • 1.44.0 Release
        • 1.43.0 Release
        • 1.42.1 Release
        • 1.42.0 Release
        • 1.41.1 Release
        • 1.41.0 Release
        • 1.40.0 Release
        • 1.39.0 Release
        • 1.38.1 Release
        • 1.38.0 Release
        • 1.37.0 Release
        • 1.36.0 Release
        • 1.35.1 Release
        • 1.35.0 Release
        • 1.34.1 Release
        • 1.34.0 Release
        • 1.33.1 Release
        • 1.33.0 Release
        • 1.32.2 Release
        • 1.32.1 Release
        • 1.32.0 Release
        • 1.31.2 Release
        • 1.31.1 Release
        • 1.31.0 Release
        • 1.30.1 Release
        • 1.30.0 Release
        • 1.29.0 Release
        • 1.28.0 Release
        • 1.27.1 Release
        • 1.27.0 Release
        • 1.26.2 Release
        • 1.26.1 Release
        • 1.26.0 Release
        • 1.25.1 Release
        • 1.25.0 Release
        • 1.24.0 Release
        • 1.23.1 Release
        • 1.23.0 Release
        • 1.22.1 Release
        • 1.22.0 Release
        • 1.21.2 Release
        • 1.21.1 Release
        • 1.21.0 Release
        • 1.20.2 Release
        • 1.20.1 Release
        • 1.20.0 Release
        • 1.19.0 Release
        • 1.18.1 Release
        • 1.18.0 Release
        • 1.17.0 Release
        • 1.16.1 Release
        • 1.16.0 Release
        • 1.15.2 Release
        • 1.15.1 Release
        • 1.15.0 Release
        • 1.14.0 Release
        • 1.13.1 Release
        • v1.13.0 Release
        • v1.12.0 Release
        • v1.11.0 Release
        • v1.10.0 Release
        • 1.9.3 Release
        • 1.9.2 Release
        • 1.9.1 Release
        • v1.9.0 Release
        • v1.8.0 Release
        • v1.7.1 Release
        • v1.7.0 Release
        • v1.6.1 Release
        • v1.6.0 Release
        • v1.5.3 Release
        • v1.5.2 Release
        • v1.5.1 Release
        • v1.5 Release
        • v1.4.1 Release
        • v1.4 Release
        • v1.3 Release
        • v1.2 Release
        • v1.1 Release
        • v1.0.1 Release
        • v1.0 Release
        • Beta Release
      • Desktop Apps
        • Release v5.0
        • Release v4.7
        • Release v4.6
        • Release v4.5
        • Release v4.4
        • Release v4.3
        • Release v4.2.3
        • Release v4.2.2
        • Release v4.2.1
        • Release v4.2.0
        • Release v4.1.2
        • Release v4.1.1
        • Release v4.1.0
        • Release v4.0.1
        • Release 4.0.0
        • Release 3.7.1
        • Release 3.7.0
        • Release 3.6.0
        • Release v3.5.0
        • Release v3.4.1
        • Release v1.3.0
        • Release v1.2.1 (Beta)
        • Release v1.1.1 (Beta)
      • Deprecated Features
        • Removed features in upcoming versions
        • Removed features by Mattermost version
    • Other Resources
      • Install on Ubuntu 18.04 LTS
        • Installing Ubuntu Server 18.04 LTS
        • Installing MySQL Database Server
        • Installing PostgreSQL Database Server
        • Installing Mattermost Server
        • Configuring Mattermost Server
        • Configuring TLS on Mattermost Server
        • Installing NGINX Server
        • Configuring NGINX as a proxy for Mattermost Server
        • Configuring NGINX with SSL and HTTP/2
      • Install on RHEL 7
        • Installing Red Hat Enterprise Linux 7
        • Installing MySQL Database Server
        • Installing PostgreSQL Database
        • Installing Mattermost Server
        • Configuring Mattermost Server
        • Configuring TLS on Mattermost Server
        • Installing NGINX Server
        • Configuring NGINX as a proxy for Mattermost Server
        • Configuring NGINX with SSL and HTTP/2
      • Deploy Mattermost on Bitnami
      • AWS Elastic Beanstalk Docker Setup
        • Configuration Settings
        • (Recommended) Enable Email
        • Sample SMTP Settings
        • Troubleshooting SMTP
      • Install Mattermost Team Edition in GitLab Helm Chart
        • Prerequisites
        • Install Mattermost Team Edition Helm Chart
        • Deploy the Mattermost Team Edition Helm Chart
        • Create an OAuth application with GitLab
        • Deploy GitLab Helm Chart
        • Deploy Mattermost Team Edition Helm Chart with GitLab Helm Chart
      • Open Source Components
        • Desktop
        • Mobile
        • Redux
        • Server
        • Webapp
  • Mattermost Administration
    • The Basics
      • Optimize Your Workspace
        • Recommendations
      • Mattermost Configuration Settings
        • Configuration in Database
        • Environment Variables
        • Override Mattermost License File
        • Load Custom Configuration Defaults
        • About
        • Reporting
        • User Management
        • Environment
        • Site Configuration
        • Authentication
        • Plugins
        • Integrations
        • Compliance
        • Experimental
        • Settings configurable only in config.json
        • Experimental Settings only in config.json
      • Mattermost Deprecated Configuration Settings
        • Service Settings
        • SQL Settings
        • Users and Teams
        • SAML 2.0
        • Legacy Sidebar
        • Town Square
        • Custom Emoji
        • Timezone
        • High-Availability
        • REST API V3
        • Integrations
        • Policy
        • Images
      • Workspace Configuration for Cloud Deployments
        • Announcement Banner
        • Emoji
        • In-Product Notices
        • File Sharing and Downloads
        • Localization
        • Notifications
        • Posts
        • Users and Teams
      • Advanced Permissions
        • Permissions structure
        • Channel Permissions
        • Recipes
        • Administration tools
        • Backend infrastructure
        • Glossary
      • Guest Accounts
        • Enabling Guest Accounts
        • Guest Authentication
        • Inviting Guests to the Mattermost Server via Email
        • Configuring AD/LDAP Authentication
        • Configuring SAML 2.0 Authentication
        • Guest Permission Settings
        • Guest Identification
        • Managing Guests
        • Disabling Guest Accounts
        • Reinstating Guest Accounts
        • Frequently Asked Questions
      • System Admin Roles
        • Assigning Admin Roles
        • Editing Privileges of Admin Roles (Advanced)
        • Admin Roles and Privileges
        • Frequently Asked Questions
      • OpenID
        • Step 1: Create an OpenID Connect Application
        • Step 2: Configure Mattermost for an OpenID Connect SSO
      • Google SSO
        • Migrating from OAuth 2.0 to OpenID Connect
        • Configuring Google Apps as a Single Sign-On (SSO) service
      • Office 365 SSO
        • Migrating from OAuth to OpenID Connect
        • Configuring Office 365 as a Single Sign-On (SSO) service
      • GitLab SSO
        • Migrating from OAuth 2.0 to OpenID Connect
        • Configuring GitLab as a Single Sign-On (SSO) service
      • Multi-factor Authentication
        • Enabling MFA
        • Enforcing MFA
      • Active Directory / LDAP
        • Overview
        • Pre-installation notes
        • Getting started
        • Configure AD/LDAP sign in
        • Configure AD/LDAP synchronization
        • Configure AD/LDAP Sign-in Using Filters
        • Configure AD/LDAP deployments with multiple domains
        • Troubleshooting/FAQ
    • Cloud Admin
      • Workspace Setup and Configuration
        • Site Configuration
        • SAML Single Sign-On
        • SAML SSO Technical Documentation
        • AD/LDAP Groups
        • Shared Channels
      • Workspace Management
        • Mattermost Cloud Billing
        • Statistics
        • User Satisfaction Surveys
        • Managing Team and Channel Members
        • Workspace Migration
        • Cloud Data Residency
      • Workspace Compliance
        • Data Retention Policy
    • Self-Hosted Admin
      • Self-Hosted Setup and Configuration
        • Initial Setup
        • Advanced Configurations
        • User Onboarding
        • Advanced User Management Configurations
      • Self-Hosted Server Management
        • Managing Team and Channel Members
        • Statistics
        • In-Product Notices
        • User Satisfaction Surveys
        • Health Check
        • Announcement Banner
        • Bulk Export Tool
      • Self-Hosted Compliance
        • Electronic Discovery
        • Compliance Export
        • Audit Log v2 (Experimental)
        • Data Retention Policy
        • Custom Terms of Service
    • Other Resources
      • Converting OAuth 2.0 Service Providers to OpenID Connect
        • Configuring OpenID Connect Single Sign-On
      • Generate a Support Packet
      • mmctl Command Line Tool
        • What’s new in Mattermost v6.0?
        • What’s changed in Mattermost v6.0?
        • mmctl usage notes
        • mmctl commands
        • Install mmctl
        • Build mmctl
        • Local mode
        • Running mmctl tests
        • mmctl auth
        • mmctl bot
        • mmctl channel
        • mmctl command
        • mmctl completion
        • mmctl config
        • mmctl docs
        • mmctl export
        • mmctl extract
        • mmctl group
        • mmctl group channel
        • mmctl group team
        • mmctl import
        • mmctl integrity
        • mmctl ldap
        • mmctl license
        • mmctl logs
        • mmctl permissions
        • mmctl plugin
        • mmctl plugin marketplace
        • mmctl post
        • mmctl roles
        • mmctl saml
        • mmctl sampledata
        • mmctl system
        • mmctl team
        • mmctl team users
        • mmctl token
        • mmctl user
        • mmctl version
        • mmctl webhook
        • mmctl websocket
      • Migration Announcement Email Template
        • Email Template
      • Advanced Permissions: Backend Infrastructure
        • Entity Definitions
        • Data Structure
      • Command Line Tools
        • Use the CLI
        • Use the CLI on GitLab Omnibus
        • Use the CLI on Docker Install
        • Use the CLI on Docker Preview
        • mattermost
        • mattermost channel
        • mattermost command
        • mattermost config
        • mattermost db init
        • mattermost db migrate
        • mattermost export
        • mattermost extract-documents-content
        • mattermost group
        • mattermost group channel
        • mattermost group team
        • mattermost help
        • mattermost import
        • mattermost integrity
        • mattermost jobserver
        • mattermost ldap
        • mattermost license
        • mattermost logs
        • mattermost permissions
        • mattermost plugin
        • mattermost reset
        • mattermost roles
        • mattermost sampledata
        • mattermost server
        • mattermost team
        • mattermost user
        • mattermost version
        • mattermost webhook
        • Executing a command hangs and doesn’t complete
      • Scripts
  • Channels
    • Access Your Workspace
      • Log In to Your Workspace
        • Email Address or Username Sign In
        • Single Sign-On
      • About Teams, Channels, and Messages
        • Teams
        • Channels
        • Messages
      • Navigate Between Teams
      • Log Out of Mattermost
    • Work With Messages
      • Messaging Basics
        • Write messages
        • Reply to messages
        • Notify teammates
        • Link to channels
        • Format your messages
        • React to messages
        • Share files
        • Save messages for follow up
      • Send and Receive Messages
        • Send a message
        • Reply to messages
        • Edit or delete messages
        • Mark messages as unread
      • Organize Conversations
        • Enable Collapsed Reply Threads (Beta)
        • Known issues
        • Start or reply to threads
        • Follow threads and messages
        • View all threads
        • Tutorial video
      • Text Formatting
        • Text Style
        • Links
        • Headings
        • Lists
        • Code Block
        • In-line Code
        • In-line Images
        • Lines
        • Block quotes
        • Tables
        • Math Formulas
      • Use Emojis
        • Adding Emojis to messages
        • Selecting recent emojis
        • Typing an emoji
        • Creating Custom Emojis
      • Mention Teammates
        • @Mentions
        • Words that trigger mentions
        • Recent mentions
        • Confirmation dialog warnings
        • Highlighting
      • Share Messages
      • Share Files
        • Attach Files to Messages
        • Preview File Attachments
        • Attachment Limits and Sizes
      • Execute Commands
        • Built-in Commands
        • Custom Commands
      • Save Messages
        • Saving a Message
        • Viewing Saved Messages
        • Unsaving Messages
      • Pin Messages
        • Pin a Message
        • Unpin a Message
      • Search
        • Searching for message contents
        • Searching for file contents
        • Search modifiers
        • Hashtags
        • Notes about all searches
        • Technical notes
    • Manage Teams, Channels, and Members
      • Create Teams
        • Methods to Create a Team
        • Team name and URL selection
        • Best practices for using a single team vs. multiple teams
      • Team Settings
        • General
        • Import
      • Manage Team Members
        • Inviting team members
        • User roles
        • Removing a user from a team or leaving a team
      • Manage Channels
        • Creating a channel
        • Creating a Direct or Group Message
        • Joining a channel
        • Adding members to a channel
        • Removing members from a channel
        • Naming a channel
        • Leaving a channel
        • Archiving a channel
        • Unarchiving a channel
        • Converting Public channels to Private channels (and vice versa)
        • Favoriting a channel
        • Muting and unmuting a channel
        • Navigating between channels
        • Navigating recently viewed channels
      • Set Channel Preferences
        • Channel notification preferences
        • Channel header
        • Channel purpose
        • Channel name
      • Organize Channels
        • The importance of channel names
        • How to navigate and organize channels
        • Channel naming examples
    • Customize Channels
      • Set Status and Availability
        • Setting a custom status
        • Clearing a custom status
        • Setting your availability
        • Setting Do Not Disturb
      • Configure Notifications
        • Desktop notifications
        • Email notifications
        • Mobile push notifications
        • Browser tab notifications
        • Muting a channel
        • Ignoring mentions
      • Organize the Sidebar
        • Channel types
        • Customizing your sidebar
        • Creating custom categories
        • Organizing channels in categories
        • Muting and unmuting categories
        • Sorting channels in categories
        • Group unread channels separately
        • Managing Direct Messages
      • Manage Your Profile
        • Profile
        • Security
      • Manage Channels Settings
        • Notifications
        • Display
        • Sidebar
        • Advanced
      • Theme Colors
        • Import Theme from Slack
        • Custom Themes
        • Standard Themes
      • Desktop App Configurations
        • Dark Theme
      • Manage Server Connections
    • Navigate Channels
      • Navigating Mattermost
        • Where is everything?
        • Account Settings
        • Status and availability
        • Product menu
        • History arrows
        • Server list
        • What else has changed?
      • Keyboard Accessibility
        • Region Navigation
        • Message Navigation
        • Channel Sidebar Navigation
      • Keyboard Shortcuts
        • Mattermost server and product navigation
        • General Mattermost navigation
        • Files
        • Messages
        • Formatting
        • Browser built-in
    • Extend Mattermost Channels
      • Extending Channels with Integrations
        • Microsoft integrations
        • CI/CD integrations
        • Atlassian integrations
        • Productivity integrations
        • Voice, video, and screensharing integrations
        • Bot integrations
        • Incoming webhooks
        • Outgoing webhooks
        • Slash commands
  • Playbooks
    • The Basics
      • Overview
      • Navigate Mattermost
        • Where is everything?
        • Account Settings
        • Status and availability
        • Product menu
        • History arrows
        • Server list
        • What else has changed?
      • Access Playbooks
        • Access playbooks and runs
      • Plan Playbooks
        • Make checklists
        • Configure templates
        • Define actions
        • Set permissions
        • Edit a playbook
        • Copying and reusing playbooks
      • Run Playbooks
        • Join a playbook run
        • Status updates
        • End a playbook run
        • Slash commands
      • Notifications and Updates
        • Follow runs and playbooks
        • Daily digest
        • Playbook to do
      • Retrospectives
        • Configuring retrospectives before a run
  • Boards
    • The Basics
      • Overview
      • Navigating Mattermost
        • Where is everything?
        • Account Settings
        • Status and availability
        • Product menu
        • History arrows
        • Server list
        • What else has changed?
      • Enable Boards
        • Configuration
      • Access Boards
      • Work With Boards
        • Adding new Boards
        • Changing views
        • Adding cards
        • Editing cards
        • Dragging cards
      • Work with Cards
        • Card descriptions
        • Customize card properties
        • Add and manage properties
        • Card badges
        • Rename a card property
        • Mention people
        • Share card previews
        • Receive updates
        • Calculations
      • Share Boards
        • Import and export a board
      • Migrate to Boards
        • Import from Asana
        • Import from Notion
        • Import from Jira
        • Import from Trello
        • Import from Todoist
      • Templates
        • Board templates
        • Share a template
        • Card templates
  • Mattermost for Developers
  • Get Help With Mattermost
  • Community Chat
Mattermost
  • Docs »
  • Mattermost Boards »
  • Navigating Mattermost
  • Search
    Edit

Navigating Mattermost 

In Mattermost v6.0, we’ve introduced changes in how to navigate Mattermost with the introduction of the Global Header. Whether you’re new to Mattermost, or a long-time user, this document will help you start using these new Global Header features as well as introduce you to some new ways of navigating the product.

The Global Header introduces a new way of navigating and using Mattermost, and offers shared functionality available across the Mattermost platform in a single place. If you’ve recently installed or upgraded to v6.0, you’ll notice that Account Settings options have been split up, the Search bar is now front and center, and we’ve introduced a Product Menu button for easy navigation between Channels, Boards, and Playbooks. You’ll notice that going forward, when you open Playbooks and Boards, they display as tabs in the window header for easier access.

We’ve also changed how you access multiple servers. Previously, multiple servers were displayed in tabs across the top of Mattermost. They’re now folded into a single menu which supports drag and drop for reordering. Notifications across servers work the same way as before, so you won’t miss any important conversations.

Mattermost server list

Where is everything? 

While Channels, Boards, and Playbooks feature unique functionality within the Global Header, the following features are shared across all three products:

  • Your user profile

  • Your status and availability

  • Product menu

In addition to this documentation, take a look at the Mattermost onboarding tips/tutorials available immediately after installation/upgrade. Note that once the tips/tutorials are dismissed, you won’t be able to access them again.

Account Settings 

The Account Settings menu has been split into Profile and Settings.

Your Profile and Security settings can be found in Profile. Select your avatar in the top-right corner of Mattermost, then choose Profile.

Channel-specific options for Notifications, Display, Sidebar, and Advanced settings are found in Settings. In Channels, select the Select the Gear icon to access Channel settings. in the Global Header, to the left of your avatar, to access Channels settings.

Status and availability 

Let your team know your online status using custom status and availability settings, which include emojis. Select your avatar in the top-right corner to change your status and availability.

Product menu 

In the top-left corner of the Global Header, select the Product menu button to navigate to Channels, Playbooks, and Boards.

Depending on permissions set for your Mattermost, this is also where you would also find Mattermost Integrations, System Console, and Marketplace menu links. You’ll always be able to view the version information of your Mattermost workspace in this menu.

History arrows 

Use the arrows to the right of the Product menu to show the last channel/next channel.

Server list 

If you’re using multiple servers (e.g., you’re running community, community-release, and a Cloud test server) the Mattermost menu is where your servers are located. To change servers, select the menu and then select the server you want to use.

What else has changed? 

Some other menu items have moved around. For example:

  • Plugins are listed in the Product menu, in the top-left corner of Mattermost.

  • System Console is listed in the Product menu, in the top-left corner of Mattermost.

  • Managing Custom Emojis can be done from the emoji picker now.

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
×
We're hiring!
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