docs/main/end-user-guide/collaborate/keyboard-shortcuts.mdx
import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';
<PlanAvailability slug="all-commercial" />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>/shortcuts slash command.The following keyboard shortcuts for channels are supported in all supported browsers and in the Mattermost desktop app.
<table> <colgroup> <col style={{width: '100%'}} /> </colgroup> <tbody> <tr> <td><blockquote> <p>On Windows & Linux | On Mac | Description |</p> </blockquote> <dl> <dt>=====================================+==============================+==================================================================================+</dt> <dd> <p><a href="mm-kbd:">Alt</a> <a href="mm-kbd:">↑</a> | <a href="mm-kbd:">⌥</a> <a href="mm-kbd:">↑</a> | Previous channel or direct message in the channel sidebar. |</p> </dd> </dl></td> </tr> <tr> <td><a href="mm-kbd:">Alt</a> <a href="mm-kbd:">↓</a> | <a href="mm-kbd:">⌥</a> <a href="mm-kbd:">↓</a> | Next channel or direct message in the channel sidebar. |</td> </tr> <tr> <td><a href="mm-kbd:">Alt</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">↑</a> | <a href="mm-kbd:">⌥</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">↑</a> | Previous channel or direct message in the channel sidebar with unread messages.</td> </tr> <tr> <td><a href="mm-kbd:">Alt</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">↓</a> | <a href="mm-kbd:">⌥</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">↓</a> | Next channel or direct message in the channel sidebar with unread messages.</td> </tr> <tr> <td><a href="mm-kbd:">Alt</a> + select channel | <a href="mm-kbd:">⌥</a> + select channel | Mark the last post in the channel as unread. |</td> </tr> <tr> <td><dl> <dt><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">K</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">K</a> | - If text isn't selected: Open the <strong>Find Channels</strong> dialog. |</dt> <dd> <div class="line-block"> | - If text is selected: Create a hyperlink in the format <code>\[linktext\](URL)</code>. |</div> </dd> </dl></td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">K</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">K</a> | Open the <strong>Direct Messages</strong> dialog.</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">A</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">A</a> | Open the <strong>Settings</strong> dialog.</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">M</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">M</a> | Open recent mentions.</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">L</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">L</a> | Set focus to center channel input field.</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">.</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">.</a> | Open or close the right-hand sidebar. |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">.</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">.</a> | Expand or shrink the width of the open right-hand sidebar.</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">F</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">F</a> | Move focus to the <strong>Search</strong> field and search the current channel.</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">U</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">U</a> | Find unread channels or search through all channels.</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">I</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">I</a> | Open or close <strong>Channel Info</strong> details in the right-hand sidebar.</td> </tr> </tbody> </table>The following keyboard shortcuts are supported in all supported browsers and in the Mattermost desktop app.
<table style={{width: '76%'}}> <colgroup> <col style={{width: '75%'}} /> </colgroup> <tbody> <tr> <td><blockquote> <p>On Windows & Linux | On Mac | Description |</p> </blockquote> <dl> <dt>=======================+====================+=================+</dt> <dd> <p><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">U</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">U</a> | Upload a file.</p> </dd> </dl></td> </tr> </tbody> </table>The following keyboard shortcuts are supported in all supported browsers and in the Mattermost desktop app.
<table> <colgroup> <col style={{width: '100%'}} /> </colgroup> <tbody> <tr> <td><blockquote> <p>On Windows & Linux | On Mac | Description |</p> </blockquote> <dl> <dt>===============================================+============================================+===========================================================+</dt> <dd> <p><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">↑</a> (in empty input field) | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">↑</a> (in empty input field) | Reprint previous message or slash command you entered. |</p> </dd> </dl></td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">↓</a> (in empty input field) | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">↓</a> (in empty input field) | Reprint next message or slash command you entered. |</td> </tr> <tr> <td><a href="mm-kbd:">Shift</a> <a href="mm-kbd:">↑</a> (in empty input field) | <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">↑</a> (in empty input field) | Reply to the most recent message in the current channel. |</td> </tr> <tr> <td><a href="mm-kbd:">↑</a> (in empty input field) | <a href="mm-kbd:">↑</a> (in empty input field) | Edit your last message in the current channel. |</td> </tr> <tr> <td><a href="mm-kbd:">@[character]</a> <a href="mm-kbd:">Tab</a> | <a href="mm-kbd:">@[character]</a> <a href="mm-kbd:">Tab</a> | Autocomplete @username beginning with [character]. |</td> </tr> <tr> <td><a href="mm-kbd:">\~[character]</a> <a href="mm-kbd:">Tab</a> | <a href="mm-kbd:">\~[character]</a> <a href="mm-kbd:">Tab</a> | Autocomplete channel beginning with [character]. |</td> </tr> <tr> <td><a href="mm-kbd:">:[character]</a> <a href="mm-kbd:">Tab</a> | <a href="mm-kbd:">:[character]</a> <a href="mm-kbd:">Tab</a> | Autocomplete emoji beginning with [character]. |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">\</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">\</a> | React to last message in channel or thread.</td> </tr> </tbody> </table>The following keyboard shortcuts are supported in all supported browsers and in the Mattermost desktop app.
<table> <colgroup> <col style={{width: '100%'}} /> </colgroup> <tbody> <tr> <td><blockquote> <p>On Windows & Linux | On Mac | Description |</p> </blockquote> <dl> <dt>===================================+=============================+========================+</dt> <dd> <p><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">B</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">B</a> | Bold text. |</p> </dd> </dl></td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">I</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">I</a> | Italicize text. |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Alt</a> <a href="mm-kbd:">K</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⌥</a> <a href="mm-kbd:">K</a> | Format text as a link.</td> </tr> </tbody> </table>The following keyboard shortcuts work in all supported browsers and in the Mattermost desktop app.
<table> <colgroup> <col style={{width: '100%'}} /> </colgroup> <tbody> <tr> <td><blockquote> <p>On Windows & Linux | On Mac | Description |</p> </blockquote> <dl> <dt>==============================================+==========================================+==================================================+</dt> <dd> <p><a href="mm-kbd:">Alt</a> <a href="mm-kbd:">←</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">[</a> | Go to the previous channel in your history.</p> </dd> </dl></td> </tr> <tr> <td><a href="mm-kbd:">Alt</a> <a href="mm-kbd:">→</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">]</a> | Go to the next channel in your history.</td> </tr> <tr> <td><a href="mm-kbd:">Shift</a> <a href="mm-kbd:">↑</a> (in input field) | <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">↑</a> (in input field) | Highlight text to the previous line.</td> </tr> <tr> <td><a href="mm-kbd:">Shift</a> <a href="mm-kbd:">↓</a> (in input field) | <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">↓</a> (in input field) | Highlight text to the next line.</td> </tr> <tr> <td><a href="mm-kbd:">Shift</a> <a href="mm-kbd:">Enter</a> (in input field) | <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">Enter</a> (in input field) | Create a new line.</td> </tr> </tbody> </table> <Note>Though Mattermost keyboard shortcuts support standard languages and keyboard layouts, they may not work if you use keymapping that overwrites default browser shortcuts.
</Note>The following keyboard shortcuts are supported in all supported browsers and in the Mattermost desktop app when calls are enabled.
<table> <colgroup> <col style={{width: '100%'}} /> </colgroup> <tbody> <tr> <td><blockquote> <p>On Windows & Linux | On Mac | Description |</p> </blockquote> <dl> <dt>===========================================================+==================================================+=========================================================================================+</dt> <dd> <p><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Alt</a> <a href="mm-kbd:">S</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⌥</a> <a href="mm-kbd:">S</a> | Start or join call in current channel. |</p> </dd> </dl></td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">Space</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">Space</a> | Mute or unmute. |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">Y</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">Y</a> | Raise or lower hand. |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">E</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">E</a> | Share or unshare screen. |</td> </tr> <tr> <td><a href="mm-kbd:">Alt</a> <a href="mm-kbd:">P</a> or <a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">P</a> | <a href="mm-kbd:">⌥</a> <a href="mm-kbd:">P</a> or <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">P</a> | Show or hide participants list.</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">L</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">L</a> | Leave current call. |</td> </tr> <tr> <td><a href="mm-kbd:">Space</a> | <a href="mm-kbd:">Space</a> | Hold to unmute (push to talk) <code>Note</code>: works in the expanded view/popout window only. |</td> </tr> </tbody> </table>The following navigation keyboard shortcuts are supported only in the Mattermost desktop app.
<Tabs> <TabItem value="desktop-app-v6-x" label="Desktop app v6.x">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:
<table> <colgroup> <col style={{width: '100%'}} /> </colgroup> <tbody> <tr> <td><blockquote> <p>On Windows & Linux | On macOS | Description |</p> </blockquote> <dl> <dt>======================================+===============================+=================================================================================================+</dt> <dd> <p><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">N</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">N</a> | Open a new window for the current server |</p> </dd> </dl></td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">T</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">T</a> | Open a new tab for the current server |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Tab</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">Tab</a> | Go to the next tab |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">Tab</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">Tab</a> | Go to the previous tab</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">1-9</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">1-9</a> | Jump to a specific tab based on its position |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">W</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">W</a> | Close current tab when multiple tabs are open |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">W</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">W</a> | Close main window</td> </tr> </tbody> </table> </TabItem> <TabItem value="desktop-app-v5-x" label="Desktop app v5.x">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.
<table> <colgroup> <col style={{width: '100%'}} /> </colgroup> <tbody> <tr> <td><blockquote> <p>On Windows & Linux | On macOS | Description |</p> </blockquote> <dl> <dt>======================================+===============================+=================================================================================================+</dt> <dd> <p><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">F</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">F</a> | Move focus to the <strong>Search</strong> field and search the current channel. |</p> </dd> </dl></td> </tr> <tr> <td><dl> <dt><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">S</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⌃</a> <a href="mm-kbd:">S</a> | Open the <strong>Servers</strong> selector, press <a href="mm-kbd:">↑</a> or <a href="mm-kbd:">↓</a> to navigate between</dt> <dd> <div class="line-block"> | servers, then press <a href="mm-kbd:">Enter</a> on Windows or Linux, or <a href="mm-kbd:">↵</a> on macOS, to select a server. |</div> </dd> </dl></td> </tr> <tr> <td><div class="line-block"><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">1</a> || <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⌃</a> <a href="mm-kbd:">1</a> || Navigate to the first server in the <strong>Servers</strong> list. |<a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">2</a> || <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⌃</a> <a href="mm-kbd:">2</a> || Replace the number with the server's position within the server in the list. |</div></td>
</tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Tab</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">Tab</a> | Navigate to the next product tab based on the current product selected. |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">Tab</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">Tab</a> | Navigate to the previous product tab based on the current product selected. |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">1</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">1</a> | Navigate to the <strong>Channels</strong> tab. |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">2</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">2</a> | Navigate to the <strong>Boards</strong> tab. |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">3</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">3</a> | Navigate to the <strong>Playbooks</strong> tab. |</td> </tr> </tbody> </table> </TabItem> <TabItem value="desktop-app-v4-7-and-earlier" label="Desktop app v4.7 and earlier">Mattermost desktop app v4.7 and earlier releases support the following navigation keyboard shortcuts:
<table> <colgroup> <col style={{width: '100%'}} /> </colgroup> <tbody> <tr> <td><blockquote> <p>On Windows & Linux | On macOS | Description |</p> </blockquote> <dl> <dt>======================================+==============================+================================================================================+</dt> <dd> <p><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">F</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">F</a> | Move focus to the <strong>Search</strong> field and search the current channel. |</p> </dd> </dl></td> </tr> <tr> <td><div class="line-block"><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">1</a> || <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">1</a> | Navigate to the first server in the <strong>Servers</strong> list. |<a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">2</a> || <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">2</a> | Replace the number with the server's tab position. |
<a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">3</a> || <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">3</a> | |</div></td>
</tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Tab</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">Tab</a> | Navigate to the next server tab based on the current server selected. |</td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">Tab</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">Tab</a> | Navigate to the previous server tab based on the current server selected.</td> </tr> <tr> <td><a href="mm-kbd:">Alt</a> <a href="mm-kbd:">↓</a> | <a href="mm-kbd:">⌥</a> <a href="mm-kbd:">↓</a> | Next channel or direct message in the channel sidebar. |</td> </tr> </tbody> </table> </TabItem> </Tabs>The following display keyboard shortcuts work in all supported browsers and in the Mattermost desktop app.
<table> <colgroup> <col style={{width: '100%'}} /> </colgroup> <tbody> <tr> <td><blockquote> <p>On Windows & Linux | On macOS | Description |</p> </blockquote> <dl> <dt>=====================================+==============================+========================================+</dt> <dd> <p><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">+</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">+</a> | Increase font size (zoom in).</p> </dd> </dl></td> </tr> <tr> <td><a href="mm-kbd:">Ctrl</a> <a href="mm-kbd:">Shift</a> <a href="mm-kbd:">-</a> | <a href="mm-kbd:">⌘</a> <a href="mm-kbd:">⇧</a> <a href="mm-kbd:">-</a> | Decrease font size (zoom out).</td> </tr> </tbody> </table> <Note>Though Mattermost keyboard shortcuts support standard languages and keyboard layouts, they may not work if you use keymapping that overwrites default browser shortcuts.
</Note>