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.

Tip

In Mattermost, display a list of available keyboard shortcuts by pressing Ctrl / on Windows or Linux, pressing ⌘ / on macOS, or using the /shortcuts slash command.
Additional keyboard shortcuts are available. See the team keyboard shortcuts documentation for details.

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`	If text isn’t selected: Open the Find Channels dialog. If text is selected: Create a hyperlink in the format `[linktext](URL)`.
`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.

Note

Though Mattermost keyboard shortcuts support standard languages and keyboard layouts, they may not work if you use keymapping that overwrites default browser shortcuts.

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 v5.0 onwards

Mattermost desktop app v5.0 introduces additional ways to navigate your Mattermost interface, including server selections, as well as tabs for channels, 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.
`Ctrl` `Tab`	`⌘` `Tab`	Navigate to the next product tab based on your current position.

Desktop app v4.7 and earlier

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).

Note

Though Mattermost keyboard shortcuts support standard languages and keyboard layouts, they may not work if you use keymapping that overwrites default browser shortcuts.