Mattermost keyboard shortcuts
Mattermost keyboard shortcuts help you make a more efficient use of your keyboard when using Mattermost in a web browser or the desktop app.
Channel navigation
The following keyboard shortcuts for channels are supported in all supported browsers and in the Mattermost desktop app.
| On Windows & Linux | On Mac | Description |
|---|---|---|
| Alt ↑ | ⌥ ↑ | Previous channel or direct message in the channel sidebar. |
| Alt ↓ | ⌥ ↓ | Next channel or direct message in the channel sidebar. |
| Alt Shift ↑ | ⌥ ⇧ ↑ | Previous channel or direct message in the channel sidebar with unread messages. |
| Alt Shift ↓ | ⌥ ⇧ ↓ | Next channel or direct message in the channel sidebar with unread messages. |
| Alt + select channel | ⌥ + select channel | Mark the last post in the channel as unread. |
| Ctrl K | ⌘ K |
|
| Ctrl Shift K | ⌘ ⇧ K | Open the Direct Messages dialog. |
| Ctrl Shift A | ⌘ ⇧ A | Open the Settings dialog. |
| Ctrl Shift M | ⌘ ⇧ M | Open recent mentions. |
| Ctrl Shift L | ⌘ ⇧ L | Set focus to center channel input field. |
| Ctrl . | ⌘ . | Open or close the right-hand sidebar. |
| Ctrl Shift . | ⌘ ⇧ . | Expand or shrink the width of the open right-hand sidebar. |
| Ctrl Shift F | ⌘ ⇧ F | Move focus to the Search field and search the current channel. |
| Ctrl Shift U | ⌘ ⇧ U | Find unread channels or search through all channels. |
| Ctrl Shift I | ⌘ ⇧ I | Open or close Channel Info details in the right-hand sidebar. |
File uploads
The following keyboard shortcuts are supported in all supported browsers and in the Mattermost desktop app.
| On Windows & Linux | On Mac | Description |
|---|---|---|
| Ctrl U | ⌘ U | Upload a file. |
Messages
The following keyboard shortcuts are supported in all supported browsers and in the Mattermost desktop app.
| On Windows & Linux | On Mac | Description |
|---|---|---|
| Ctrl ↑ (in empty input field) | ⌘ ↑ (in empty input field) | Reprint previous message or slash command you entered. |
| Ctrl ↓ (in empty input field) | ⌘ ↓ (in empty input field) | Reprint next message or slash command you entered. |
| Shift ↑ (in empty input field) | ⇧ ↑ (in empty input field) | Reply to the most recent message in the current channel. |
| ↑ (in empty input field) | ↑ (in empty input field) | Edit your last message in the current channel. |
| @[character] Tab | @[character] Tab | Autocomplete @username beginning with [character]. |
| ~[character] Tab | ~[character] Tab | Autocomplete channel beginning with [character]. |
| :[character] Tab | :[character] Tab | Autocomplete emoji beginning with [character]. |
| Ctrl Shift \ | ⌘ ⇧ \ | React to last message in channel or thread. |
Message formatting
The following keyboard shortcuts are supported in all supported browsers and in the Mattermost desktop app.
| On Windows & Linux | On Mac | Description |
|---|---|---|
| Ctrl B | ⌘ B | Bold text. |
| Ctrl I | ⌘ I | Italicize text. |
| Ctrl Alt K | ⌘ ⌥ K | Format text as a link. |
Accessibility nagivation
The following keyboard shortcuts work in all supported browsers and in the Mattermost desktop app.
| On Windows & Linux | On Mac | Description |
|---|---|---|
| Alt ← | ⌘ [ | Go to the previous channel in your history. |
| Alt → | ⌘ ] | Go to the next channel in your history. |
| Shift ↑ (in input field) | ⇧ ↑ (in input field) | Highlight text to the previous line. |
| Shift ↓ (in input field) | ⇧ ↓ (in input field) | Highlight text to the next line. |
| Shift Enter (in input field) | ⇧ Enter (in input field) | Create a new line. |
Calls
The following keyboard shortcuts are supported in all supported browsers and in the Mattermost desktop app when calls are enabled.
| On Windows & Linux | On Mac | Description |
|---|---|---|
| Ctrl Alt S | ⌘ ⌥ S | Start or join call in current channel. |
| Ctrl Shift Space | ⌘ ⇧ Space | Mute or unmute. |
| Ctrl Shift Y | ⌘ ⇧ Y | Raise or lower hand. |
| Ctrl Shift E | ⌘ ⇧ E | Share or unshare screen. |
| Alt P or Ctrl Shift P | ⌥ P or ⌘ ⇧ P | Show or hide participants list. |
| Ctrl Shift L | ⌘ ⇧ L | Leave current call. |
| Space | Space | Hold to unmute (push to talk) Note: works in the expanded view/popout window only. |
Navigation in the desktop app
The following navigation keyboard shortcuts are supported only in the Mattermost desktop app.
- Desktop app v6.x
- Desktop app v5.x
- Desktop app v4.7 and earlier
Mattermost desktop app v6.0 introduces the ability to keep multiple workspaces open at the same time and work across them without constant switching contexts. The following keyboard shortcuts help you navigate multiple views:
| On Windows & Linux | On macOS | Description |
|---|---|---|
| Ctrl N | ⌘ N | Open a new window for the current server |
| Ctrl T | ⌘ T | Open a new tab for the current server |
| Ctrl Tab | ⌘ Tab | Go to the next tab |
| Ctrl Shift Tab | ⌘ ⇧ Tab | Go to the previous tab |
| Ctrl 1-9 | ⌘ 1-9 | Jump to a specific tab based on its position |
| Ctrl W | ⌘ W | Close current tab when multiple tabs are open |
| Ctrl Shift W | ⌘ ⇧ W | Close main window |
Mattermost desktop app v5.0 introduces additional ways to navigate your Mattermost interface, including server selections, as well as tabs for channels, collaborative playbooks, and boards.
| On Windows & Linux | On macOS | Description |
|---|---|---|
| Ctrl F | ⌘ F | Move focus to the Search field and search the current channel. |
| Ctrl Shift S | ⌘ ⌃ S | Open the Servers selector, press ↑ or ↓ to navigate between servers, then press Enter on Windows or Linux, or ↵ on macOS, to select a server. |
| Ctrl Shift 1 Ctrl Shift 2 | ⌘ ⌃ 1 ⌘ ⌃ 2 | Navigate to the first server in the Servers list. Replace the number with the server's position within the server in the list. |
| Ctrl Tab | ⌘ Tab | Navigate to the next product tab based on the current product selected. |
| Ctrl Shift Tab | ⌘ ⇧ Tab | Navigate to the previous product tab based on the current product selected. |
| Ctrl 1 | ⌘ 1 | Navigate to the Channels tab. |
| Ctrl 2 | ⌘ 2 | Navigate to the Boards tab. |
| Ctrl 3 | ⌘ 3 | Navigate to the Playbooks tab. |
Mattermost desktop app v4.7 and earlier releases support the following navigation keyboard shortcuts:
| On Windows & Linux | On macOS | Description |
|---|---|---|
| Ctrl F | ⌘ F | Move focus to the Search field and search the current channel. |
| Ctrl 1 Ctrl 2 Ctrl 3 | ⌘ 1 ⌘ 2 ⌘ 3 | Navigate to the first server in the Servers list. Replace the number with the server's tab position. |
| Ctrl Tab | ⌘ Tab | Navigate to the next server tab based on the current server selected. |
| Ctrl Shift Tab | ⌘ ⇧ Tab | Navigate to the previous server tab based on the current server selected. |
| Alt ↓ | ⌥ ↓ | Next channel or direct message in the channel sidebar. |
Zoom in & zoom out display
The following display keyboard shortcuts work in all supported browsers and in the Mattermost desktop app.
| On Windows & Linux | On macOS | Description |
|---|---|---|
| Ctrl Shift + | ⌘ ⇧ + | Increase font size (zoom in). |
| Ctrl Shift - | ⌘ ⇧ - | Decrease font size (zoom out). |