zulip/templates/zerver/help/keyboard-shortcuts.md

# Keyboard shortcuts

Keyboard shortcuts allow a user to use Zulip easily and efficiently
for a better user experience.

Zulip keyboard shortcuts are divided into four categories:

* [Navigation](#navigation)
* [Composing messages](#composing-messages)
* [Narrowing](#narrowing)
* [Menus](#menus)

!!! warn ""
    Note: We note how to enter keyboard shortcuts using keys not
    present on MacOS keyboard in parentheticals below.

## Navigation

* **Initiate a search**: `/` - This shortcut moves the user's cursor to
  the message search bar at the top of the window to allow them to
  begin searching for messages belonging to a specific topic, stream,
  view, etc. in the organization.
* **Search people**: `q` - This shortcut moves the user's cursor to the
  user search bar in the right sidebar to to allow them to begin
  searching for a particular user in the organization.
* **Search streams**: `w` - This shortcut moves the user's cursor to
  the stream search bar in the left sidebar to to allow them to begin
  searching for a particular stream in the organization.
* **Previous message**: `k` or `↑` - This shortcut allows the user
  to scroll up to the previous message in their view.
* **Next message**: `j` or `↓` - This shortcut allows the user to
  scroll down to the next message in their view.
* **Scroll up**: `K` or `PgUp` (`Fn` + `↑` on Mac) - This shortcut
  allows the user to scroll up through the messages in their view.
* **Scroll down**: `J`, `Spacebar`, or `PgDn` (`Fn` + `↓` on Mac) -
  This shortcut allows the user to scroll down through the messages in
  their view.
* **Last message**: `End` (`Fn`+`⇾` on Mac) or `G` - This shortcut
  allows the user to scroll to the most recent message in their view.
* **First message in view**: `Home` (`Fn`+`⇽` on Mac) - This shortcut
  allows the user to scroll to the most recent message in their view.

## Composing messages

* **Reply to message**: `r` or `Enter` (`Return` on Mac) - This
  shortcut allows the user to begin replying to the selected message
  (outlined in blue).
* **Reply to author**: `R` - This shortcut allows the user to begin
  writing a private message to the author of the selected message
  (outlined in blue).
* **Reply to message mentioning the author**: `@` - This
  shortcut allows the user to begin replying to the selected message
  (outlined in blue), @-mentioning the author of the selected message.
* **New stream message**: `c` - This shortcut allows the user to begin
  composing a new stream message.
* **New private message**: `C` - This shortcut allows the user to begin
  composing a new private message.
* **Send message**: `Tab key` then `Enter` (`Return` on Mac) - This
  shortcut allows the user to send the message that they've written.
* **Cancel compose**: `Esc` or `Ctrl + [` - This shortcut allows the user to cancel
  and discard their unsent message.
* **View drafts**: `d` - This shortcut allows the user to open the
  drafts overlay.

## Narrowing

* **Narrow by stream**: `s` - This shortcut narrows the view to show
  all messages in the stream of the selected message (outlined in
  blue).
* **Narrow by topic**: `S` - This shortcut narrows the view to show all
  messages with the topic of the selected message (outlined in blue).
* **Narrow to all private messages**: `P` - This shortcut narrows the
  view to show all of the user's private messages.
* **Narrow to next unread topic**: `n` - This shortcut narrows the
  view to the next unread topic in the stream sidebar.
* **Cycle between stream narrows**: `A` and `D` - This shortcut allows the
  user to cycle through the narrows showing the messages of a stream
  according to Stream order in the left sidebar. `A` allows the user
  to navigate to the previous stream narrow, and `D` allows the user
  to navigate to the next stream narrow.
* **Return to home view**: `Esc` or `Ctrl + [` - This shortcut makes the user return
  to the Home view, showing all messages in the organization.

## Menus

* **Open message actions menu**: `i` - This shortcut shows the
  available message actions of the selected message (outlined in
  blue).
* **Open lightbox for selected message**: `v` - This opens the lightbox
  if the selected message has images or videos embedded.
* **Edit last message you sent**: `⇽` - This starts editing the
  last editable message that you sent in the current view (if any).
* **Edit selected message**: `i` then `Enter` (`Return` on Mac) -
  This shortcut allows the user to edit the selected message (outlined
  in blue) if the user authored the selected message. If the selected
  message was written by another user, this shortcut will enable the
  user to view the source code of the message.
* **Toggle starred flag**: `*` - This shortcut stars the selected
  message.
* **Show the keyboard shortcuts**: `?` - This shortcut makes a modal
  window with a guide to all possible keyboard shortcuts appear.
* **Open gear menu**: `g` - This shortcut opens the page's upper-right
  gear menu.
* **Open reaction popover menu**: `:` - This shortcut shows the
  reaction popover menu of the selected message (outlined in blue).
* **React to selected message with +1**: `+` - This shortcut allows
  you to react to the selected message (outlined in blue) with the
  +1 (thumbs up) emoji.
* **Mute/Unmute topic**: `M` - This shortcut toggles the selected
  message's (outlined in blue) topic between muted and unmuted.