zulip/templates/zerver/help/streams-and-private-message...

5.5 KiB

Streams and private messages

Streams and private messages overview

Zulip supports both private messaging and group chats via conversation streams.

Streams are either:

  • Public - Public streams are for open discussions. All users can subscribe to public streams and discuss there. Any Zulip user can join any public stream in the realm, and can view the complete message history of any public stream without joining the stream.
  • Private - Private streams are for confidential discussions and are only visible to users who've been invited to subscribe to them. Users who are not members of a private stream cannot subscribe to the stream or read or send messages to the stream.

Private messaging can either be one-on-one or group conversations. They can only be seen by users participating in the message.

Creating a new stream message

New stream message

To submit a new stream message, first click the New stream message button located at the bottom of your screen.

New stream message

A box similar to the one shown in the previous image will appear.

In the Stream field, input the stream name of the message you want your message to be located in. When you begin typing a stream name, autocomplete suggestions will appear.

Stream does not exist

If you attempt to input a nonexistent stream name, an error message will appear.

Once you have entered your stream name, enter the topic for your message in the Topic field. Your topic name can be no longer than 52 characters.

Finally, enter your message in the box labeled Compose your message here... or messaging box. You can now send your message to the specified stream under the specified topic.

You can always delete your message by clicking the x (x) icon located at the top-right corner of your messaging box.

Private messaging

New private message

To submit a new stream message, first click the New private message button located at the bottom of your screen.

New stream message

A box similar to the one shown in the previous image will appear.

In the one or more people... field, input the username or email address of the user you want to privately message. When you begin typing an email address or username, autocomplete suggestions will appear.

Nobody does not exist

If you attempt to input a nonexistent username or email address, an error message will appear.

Once you have selected the user you want to message, enter your message in the box labeled Compose your message here... or messaging box. You can now privately send your message to the specified user.

You can always delete your message by clicking the x (x) icon located at the top-right corner of your messaging box.

Other features

While sending either a stream or private message, several features located below the messaging bn the bottom-left corner can aid you in composing your message.

Emoji

Emoji feature

Clicking the smiley face (smiley face) icon allows a box to appear featuring Zulip's vast collection of emojis. You can select an emoji to include in your message.

Attach files

File upload feature

Clicking the paper clip (paper clip) icon allows you to select a file from your computer and attach it to your message, uploading it to Zulip to share with your peers.

File upload feature

While the file is uploading, a blue box labeled Uploading... will appear, and a link to your file will be included in your message once the file has been uploaded.

Formatting

Message formatting modal

Clicking the A (A) icon will reveal a modal window with a summary of message formatting in Zulip. For more information on message formatting, see our message formatting guide.

Restore draft

Restore draft

If you accidentally delete your message by clicking the x (x) icon in the upper right corner of your messaging box, you can restore your previous message by clicking a blue link labeled Restore draft, which appears between the A (A) and eye (eye) icons.

Preview

Message preview

Clicking the eye (eye) icon will allow you to preview your message. To resume editing your message, click the pencil and paper (pencil and paper) icon that has replaced the eye icon.

Press Enter to send

Press enter to send

The Press Enter to send checkbox allows you to automatically send your message when you press the enter (or return) key on your keyboard.

Send button

If the box is unchecked, a green Send button will appear. You will have to click on the Send button to send your message.