2017-01-25 00:37:21 +01:00
|
|
|
# Keyboard shortcuts
|
2017-01-05 23:35:54 +01:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
Everything in Zulip can be done with the mouse, but mastering a few keyboard
|
2022-12-06 23:23:43 +01:00
|
|
|
shortcuts will change your experience of the app. Start with the basics below,
|
|
|
|
and use the convenient [**keyboard shortcuts reference**](#keyboard-shortcuts-reference)
|
|
|
|
in the Zulip app to add more to your repertoire as needed.
|
2017-05-12 03:46:24 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* [The basics](#the-basics)
|
2016-12-09 18:20:59 +01:00
|
|
|
* [Navigation](#navigation)
|
|
|
|
* [Narrowing](#narrowing)
|
2017-07-28 06:47:50 +02:00
|
|
|
* [Composing messages](#composing-messages)
|
2017-05-13 03:24:17 +02:00
|
|
|
* [Message actions](#message-actions)
|
|
|
|
* [Drafts](#drafts)
|
2017-07-28 06:47:50 +02:00
|
|
|
* [Menus](#menus)
|
|
|
|
* [Streams settings](#streams-settings-page)
|
2016-12-09 18:20:59 +01:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
## The basics
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Reply to message**: <kbd>R</kbd> or <kbd>Enter</kbd> — Reply to the
|
|
|
|
selected message (outlined in blue).
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **New stream message**: <kbd>C</kbd> — Start a new topic in the current
|
|
|
|
stream.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2023-02-10 08:04:36 +01:00
|
|
|
* **New direct message**: <kbd>X</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Cancel compose and save draft**: <kbd>Esc</kbd> or <kbd>Ctrl</kbd> +
|
|
|
|
<kbd>[</kbd> — Close the compose box and save the unsent message as a
|
|
|
|
draft.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **View drafts**: <kbd>D</kbd> — Use the arrow keys and <kbd>Enter</kbd>
|
|
|
|
to restore a draft. Press <kbd>D</kbd> again to close.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Next message**: <kbd class="arrow-key">↓</kbd> or <kbd>J</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Last message**: <kbd>End</kbd> or <kbd>Shift</kbd> + <kbd>G</kbd> —
|
|
|
|
Also marks all messages in the current view as read.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Next unread topic**: <kbd>N</kbd>
|
2016-12-09 18:20:59 +01:00
|
|
|
|
2023-02-10 08:04:36 +01:00
|
|
|
* **Next unread direct message**: <kbd>P</kbd>
|
2018-02-16 15:56:25 +01:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Search messages**: <kbd>/</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Toggle keyboard shortcuts view**: <kbd>?</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Go to default view**: <kbd>Ctrl</kbd> + <kbd>[</kbd> (or
|
|
|
|
<kbd>Esc</kbd>, [if enabled][disable-escape])
|
2021-10-25 19:17:19 +02:00
|
|
|
until you are in the [default view](/help/configure-default-view).
|
2021-03-10 13:56:10 +01:00
|
|
|
|
2021-10-25 19:17:19 +02:00
|
|
|
[disable-escape]: /help/configure-default-view#set-whether-esc-navigates-to-the-default-view
|
2017-07-28 06:47:50 +02:00
|
|
|
## Navigation
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Search messages**: <kbd>/</kbd> or <kbd>Ctrl</kbd> + <kbd>K</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Filter streams**: <kbd>Q</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Search people**: <kbd>W</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Last message**: <kbd>End</kbd> or <kbd>Shift</kbd> + <kbd>G</kbd> —
|
|
|
|
Also marks all messages in the current view as read.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **First message**: <kbd>Home</kbd>
|
2017-07-28 06:47:50 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Previous message**: <kbd class="arrow-key">↑</kbd> or <kbd>K</kbd>
|
2017-07-28 06:47:50 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Next message**: <kbd class="arrow-key">↓</kbd> or <kbd>J</kbd>
|
2017-07-28 06:47:50 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Scroll up**: <kbd>PgUp</kbd> or <kbd>Shift</kbd> + <kbd>K</kbd>
|
2017-07-28 06:47:50 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Scroll down**: <kbd>PgDn</kbd>, <kbd>Shift</kbd> + <kbd>J</kbd>, or
|
|
|
|
<kbd>Spacebar</kbd>
|
2016-12-09 18:20:59 +01:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Go back through viewing history**: <kbd>Alt</kbd> +
|
|
|
|
<kbd class="arrow-key">←</kbd>
|
2022-07-13 12:28:12 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Go forward through viewing history**: <kbd>Alt</kbd> +
|
|
|
|
<kbd class="arrow-key">→</kbd>
|
2022-07-13 12:28:12 +02:00
|
|
|
|
2016-12-09 18:20:59 +01:00
|
|
|
## Narrowing
|
2017-01-05 23:35:54 +01:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Narrow to next unread topic**: <kbd>N</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2023-02-10 08:04:36 +01:00
|
|
|
* **Narrow to next unread direct message**: <kbd>P</kbd>
|
2018-02-16 15:56:25 +01:00
|
|
|
|
2023-02-03 12:25:44 +01:00
|
|
|
* **Narrow to topic or DM conversation**: <kbd>S</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2023-02-03 12:25:44 +01:00
|
|
|
* **Narrow to stream from topic view**: <kbd>S</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2023-02-10 08:04:36 +01:00
|
|
|
* **Narrow to all direct messages**: <kbd>Shift</kbd> + <kbd>P</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2023-02-01 11:58:08 +01:00
|
|
|
* **Zoom to message in conversation context**: <kbd>Z</kbd> — This view does not mark messages as read.
|
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Cycle between stream narrows**: <kbd>Shift</kbd> + <kbd>A</kbd>
|
|
|
|
(previous) and <kbd>Shift</kbd> + <kbd>D</kbd> (next)
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-12-14 21:47:52 +01:00
|
|
|
* **Narrow to All messages**: <kbd>A</kbd> — Shows all unmuted messages.
|
2016-12-09 18:20:59 +01:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Narrow to current compose box recipient**: <kbd>Ctrl</kbd> + <kbd>.</kbd>
|
2018-11-30 00:20:10 +01:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
## Composing messages
|
2017-01-05 23:35:54 +01:00
|
|
|
|
2023-05-29 03:36:58 +02:00
|
|
|
* **New stream message**: <kbd>C</kbd> — For starting a new topic in a
|
|
|
|
stream.
|
|
|
|
|
|
|
|
* **New direct message**: <kbd>X</kbd>
|
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Reply to message**: <kbd>R</kbd> or <kbd>Enter</kbd> — Reply to the
|
|
|
|
selected message (outlined in blue). Same behavior as clicking on the
|
|
|
|
message.
|
2017-05-24 21:32:07 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Quote and reply to message**: <kbd>></kbd>
|
2018-01-31 04:23:02 +01:00
|
|
|
|
2023-05-29 03:36:58 +02:00
|
|
|
* **Reply directly to sender**: <kbd>Shift</kbd> + <kbd>R</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2023-05-29 03:36:58 +02:00
|
|
|
* **Reply @-mentioning sender**: <kbd>@</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
### In the compose box
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Send message**: <kbd>Enter</kbd>, <kbd>Tab</kbd> then <kbd>Enter</kbd>,
|
|
|
|
and/or <kbd>Ctrl</kbd> + <kbd>Enter</kbd>, depending on your settings. See
|
2022-09-13 03:18:30 +02:00
|
|
|
[enable enter to send](/help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message).
|
2017-06-16 06:55:07 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Insert new line**: <kbd>Enter</kbd>, or <kbd>Shift</kbd> + <kbd>Enter</kbd>,
|
|
|
|
depending on your settings. See
|
2022-09-13 03:18:30 +02:00
|
|
|
[enable enter to send](/help/mastering-the-compose-box#toggle-between-ctrl-enter-and-enter-to-send-a-message).
|
2017-05-13 03:24:17 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Insert italic text**: `*italic*` or <kbd>Ctrl</kbd> + <kbd>I</kbd>
|
|
|
|
|
|
|
|
* **Insert bold text**: `**bold**` or <kbd>Ctrl</kbd> + <kbd>B</kbd>
|
|
|
|
|
|
|
|
* **Insert link**: `[Zulip website](https://zulip.org)` or <kbd>Ctrl</kbd> +
|
|
|
|
<kbd>Shift</kbd> + <kbd>L</kbd>
|
2019-06-10 09:21:04 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Cancel compose and save draft**: <kbd>Esc</kbd> or <kbd>Ctrl</kbd> +
|
|
|
|
<kbd>[</kbd> — Close the compose box and save the unsent message as a draft.
|
2017-07-28 06:47:50 +02:00
|
|
|
|
|
|
|
## Message actions
|
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Edit last message**: <kbd class="arrow-key">←</kbd> — Open the last
|
|
|
|
editable message in the current view (if any).
|
2017-07-28 06:47:50 +02:00
|
|
|
|
|
|
|
### For a selected message (outlined in blue)
|
|
|
|
|
2022-11-14 18:00:29 +01:00
|
|
|
* **Show message sender's user card**: <kbd>U</kbd>
|
2017-05-13 03:24:17 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **View image**: <kbd>V</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-10-05 18:36:44 +02:00
|
|
|
* **Edit message or view message source**: <kbd>E</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-10-13 08:47:36 +02:00
|
|
|
* **Move message and (optionally) other messages in the same topic**: <kbd>M</kbd>
|
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Star message**: <kbd>Ctrl</kbd> + <kbd>S</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
* **React with <img alt=":thumbs_up:" class="emoji"
|
2022-06-02 01:56:59 +02:00
|
|
|
src="/static/generated/emoji/images/emoji/unicode/1f44d.png"
|
|
|
|
title="thumbs up"/>**: <kbd>+</kbd>
|
2017-07-28 06:47:50 +02:00
|
|
|
|
2023-03-23 02:24:06 +01:00
|
|
|
* **Toggle first emoji reaction**: <kbd>=</kbd>
|
|
|
|
|
2021-08-05 00:59:03 +02:00
|
|
|
* **Mark as unread from selected message**: <kbd>Shift</kbd> + <kbd>U</kbd>
|
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Collapse/show message**: <kbd>-</kbd>
|
2017-07-28 06:47:50 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Toggle topic mute**: <kbd>Shift</kbd> + <kbd>M</kbd> — Muted topics
|
2022-12-14 21:47:52 +01:00
|
|
|
don't show up in any views (including **All messages**), and don't contribute
|
2023-04-23 03:17:52 +02:00
|
|
|
to unread counts. Read more about [muting or unmuting topics](/help/mute-a-topic).
|
2017-05-13 03:24:17 +02:00
|
|
|
|
2022-10-12 19:54:34 +02:00
|
|
|
## Recent conversations
|
2020-06-26 10:22:19 +02:00
|
|
|
|
2022-10-12 19:54:34 +02:00
|
|
|
* **View recent conversations**: <kbd>T</kbd>
|
2022-06-02 01:56:59 +02:00
|
|
|
|
2022-10-12 19:54:34 +02:00
|
|
|
* **Search recent conversations**: <kbd>T</kbd>
|
2022-06-02 01:56:59 +02:00
|
|
|
|
2022-10-12 19:54:34 +02:00
|
|
|
* **Escape from recent conversations search**: <kbd>Esc</kbd> or arrow keys
|
2022-06-02 01:56:59 +02:00
|
|
|
|
2022-10-12 19:54:34 +02:00
|
|
|
* **Navigate recent conversations**: Use arrow keys or vim keys
|
|
|
|
(<kbd>J</kbd>, <kbd>K</kbd>, <kbd>L</kbd>, <kbd>H</kbd>).
|
2020-06-26 10:22:19 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
Use <kbd>Enter</kbd> to engage with elements.
|
2020-06-26 10:22:19 +02:00
|
|
|
|
2017-05-13 03:24:17 +02:00
|
|
|
## Drafts
|
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Toggle drafts view**: <kbd>D</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
### Within the drafts view
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Edit selected draft**: <kbd>Enter</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Delete selected draft**: <kbd>Backspace</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
Keyboard navigation (e.g. arrow keys) works as expected.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
## Menus
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Toggle shortcuts help**: <kbd>?</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Toggle gear menu**: <kbd>G</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
### For a selected message (outlined in blue)
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Toggle emoji reactions menu**: <kbd>:</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Toggle message actions menu**: <kbd>I</kbd>
|
2017-07-28 06:47:50 +02:00
|
|
|
|
|
|
|
## Streams settings page
|
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Scroll through streams**: <kbd class="arrow-key">↑</kbd> and
|
|
|
|
<kbd class="arrow-key">↓</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
|
|
|
!!! tip ""
|
2021-09-10 00:44:29 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
Pressing <kbd class="arrow-key">↑</kbd> from the first stream
|
|
|
|
in the list moves you to the **Filter streams** input.
|
2017-07-28 06:47:50 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Switch between tabs**: <kbd class="arrow-key">←</kbd> and
|
|
|
|
<kbd class="arrow-key">→</kbd> — Switch between the **Subscribed**
|
|
|
|
and **All streams** tabs.
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Create new stream**: <kbd>N</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2017-07-28 06:47:50 +02:00
|
|
|
### For a selected stream
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **View stream messages**: <kbd>Shift</kbd> + <kbd>V</kbd>
|
2017-05-24 20:51:49 +02:00
|
|
|
|
2022-06-02 01:56:59 +02:00
|
|
|
* **Toggle subscription**: <kbd>Shift</kbd> + <kbd>S</kbd>
|
2022-12-06 23:23:43 +01:00
|
|
|
|
|
|
|
|
|
|
|
## Keyboard shortcuts reference
|
|
|
|
|
|
|
|
A summary of the keyboard shortcuts above is available in the Zulip app.
|
|
|
|
|
|
|
|
{start_tabs}
|
|
|
|
|
2023-07-21 03:22:29 +02:00
|
|
|
{relative|gear|keyboard-shortcuts}
|
|
|
|
|
|
|
|
!!! tip ""
|
|
|
|
|
|
|
|
You can also click the **keyboard** (<i class="fa fa-keyboard-o"></i>)
|
|
|
|
icon at the bottom of the app, just below the right sidebar.
|
2022-12-06 23:23:43 +01:00
|
|
|
|
|
|
|
{end_tabs}
|
|
|
|
|
|
|
|
## Related articles
|
|
|
|
|
|
|
|
* [Reading strategies](/help/reading-strategies)
|