Getting started with Zulip
Welcome to Zulip! This page guides you through getting started using
Zulip. If you are setting up a new organization, you may also want to
check out our guide for setting up a new Zulip
organization.
Mastering Zulip can take a bit of time, but once you get the hang of
it, you'll never want to use a different team chat app!
Set up your account
If this is your first time using Zulip, we recommend starting with the web
or desktop experience to set up your account and get oriented.
Learn about Zulip topics
In Zulip, streams determine who gets a message. Topics tell you what the
message is about.
Topics are light-weight subjects, very similar to the subject line of an email.
Like in email or a forum, messages about the same topic are shown together as a
conversational thread. Here is what it looks like in Zulip.
Topics are one of the most wonderful aspects of using Zulip:
- Lots of conversations can happen in the same stream at the same time, each in
its own topic. You never have to worry about interrupting — each
conversation has its own space.
- Conversations can last many hours or days, letting everyone respond in their
own time. Don't worry about replying long after a message is sent —
everyone will see your reply in context.
Check out Why Zulip to learn more about how Zulip's topic model
helps transform how your organization communicates.
Reading your messages
Like your email inbox, Zulip works best if you read it topic-by-topic.
Finding a topic to read
From Recent conversations
In Zulip, a conversation is a direct message thread
(one-on-one or with a group), or a topic in a
stream. Use the Recent conversations view to get
an overview of all the ongoing conversations. This view is particularly useful
for catching up on messages sent while you were away.
- Instructions for all platforms
-
Click Recent conversations in the left sidebar.
-
The filters at the top help you quickly find relevant conversations.
For example, select Participated to narrow to the topics you
have sent messages to.
The Participants column shows which users recently sent a message (newest on the left).
From the list of streams
In the left sidebar, you can see the streams you are subscribed to, along with
unread message counts for each stream.
- Instructions for all platforms
-
Click on the name of a stream in the left sidebar. You will see a list of the
most recent unread topics in that stream.
-
The initially shown list of topics usually has what you need, but you can
click on more topics underneath to see additional topics.
Older topics disappear from the left sidebar, but you can always find them
by clicking more topics or by using search.
Reading topics
- Via recent conversations
- Via left sidebar
-
Click Recent conversations in the left sidebar.
-
Click on the name of a topic in the Topic column.
-
Read the topic, scrolling down with the mouse or by pressing
PgDn.
-
If the topic is not of interest, you can
mark all messages as read by
jumping to the bottom with the Scroll to bottom
() button or the End shortcut.
-
You can then click on another topic in the left sidebar, use the
N key to go to the next unread topic, or go back to the
Recent conversations view.
-
Click on the name of a stream in the left sidebar. You will see a
list of the most recent unread topics in that stream.
-
Click on a topic in the left sidebar.
-
Read the topic, scrolling down with the mouse or by pressing
PgDn.
-
If the topic is not of interest, you can
mark all messages as read by
jumping to the bottom with the Scroll to bottom
() button or the End shortcut.
-
Click on the next topic in the left sidebar, or use the N
key to go to the next unread topic.
-
To go to older unread topics, use the N key or click
more topics to view.
Reading direct messages
- Instructions for all platforms
-
If the Direct messages section in the left sidebar is collapsed, click
on it to expand it.
-
Click on a conversation under Direct messages.
-
Read the conversation, scrolling down with the mouse or by pressing
PgDn.
-
If the conversation is not of interest, you can
mark all messages as read by
jumping to the bottom with the Scroll to bottom
() button or the End shortcut.
-
Click on the next conversation in the left sidebar, or use the
P key to go to the next unread conversation.
-
To view all your direct message conversations, click the more
conversations link at the bottom of the Direct messages section.
Sending messages
When to start a new topic
To get the full benefits of Zulip's topic model, when starting a new
conversation, you should start a new topic!
Starting a topic is like a lighter weight version of giving your email a subject.
Topic names should be brief but specific, e.g.:
- Good topic names: "question about topics", "welcome Anna Smith!", "issue #1234"
- Not so good topic names: "question", "hi", "help", "this topic is about
a question I have about topics"
Don't overthink naming your topic. The first 2-3 words that come to mind
are probably fine!
How to start a new topic
- From a stream view
- From other views
-
Click the New topic button at the bottom of the app, or
use the C keyboard shortcut.
-
Enter a topic name. Auto-complete will provide suggestions for previously
used topics.
-
Click on the compose box, or press Tab to compose your message. You
can preview your message before
sending.
-
Click Send, or use a keyboard
shortcut
to send your message.
You can change the destination stream for your message using the dropdown
in the top left of the compose box.
-
Click the New topic button at the bottom of the app, or
use the C keyboard shortcut.
-
Select a stream from the dropdown in the top left of the compose box. You can
start typing to filter streams.
-
Enter a topic name. Auto-complete will provide suggestions for previously
used topics.
-
Click on the compose box, or press Tab to compose your message. You
can preview your message before
sending.
-
Click Send, or use a keyboard
shortcut
to send your message.
In Zulip, you can compose a message to a different place than the one you
are viewing. In this situation, the message feed will fade to indicate
what's going on.
Starting a new direct message
-
Click the New direct message button at the bottom of the app, or
use the X keyboard shortcut.
-
Start typing the name of the person you want to message, and
select their name from the list of suggestions. You can continue
adding as many message recipients as you like.
-
Click on the compose box, or press Tab to compose your message. You
can preview your message before
sending.
-
Click Send, or use a keyboard
shortcut
to send your message.
You can switch from composing a stream message to composing a direct
message by selecting Direct message from the dropdown in the upper left
of the compose box.
-
Tap the Private messages
( )
tab at the bottom of the app.
-
Tap the New group PM button at the top of the app.
-
Start typing the name of the person you want to message, and
select their name from the list of suggestions. You can continue
adding as many message recipients as you like.
-
Approve by tapping the checkmark
()
button in the bottom right corner of the app.
-
Compose your message, and tap the send
()
button in the bottom right corner of the app.
Rather than kicking off a group direct message, consider starting the
conversation in a new topic to make it easier to browse later on.
Responding to an existing thread
To reply to an existing thread:
- Instructions for all platforms
-
Click the Message... button at the bottom of the app.
-
Compose your message. You
can preview your message before
sending.
-
Click Send, or use a keyboard
shortcut
to send your message.
You can also reply by clicking on a message, or using the R or
Enter keyboard shortcuts to reply to the message in the blue box.
Messaging tips & tricks
Related articles