zulip/help/link-to-a-message-or-conver...

3.5 KiB

Link to a message or conversation

Zulip makes it easy to share links to messages, topics, and channels. You can link from one Zulip conversation to another, or share links to Zulip conversations in issue trackers, emails, or other external tools.

Zulip automatically creates links to channels and topics in messages you send.

The easiest way to link to a channel or topic is:

{start_tabs}

  1. Type # followed by the one or more letters of the channel name.

  2. Choose the desired channel from the auto-complete menu. The link will be automatically formatted for you.

  3. If linking to a topic, type > after selecting a channel as described above, followed by one or more letters of the topic name.

  4. Choose the desired topic from the auto-complete menu. The link will be automatically formatted for you.

!!! tip ""

When you paste a topic or channel link into Zulip, it is automatically
formatted for you. You can paste as plain text if you prefer with
<kbd data-mac-following-key="⌥">Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>V</kbd>.

{end_tabs}

Alternatively, it is possible to manually format channel and topic links:

Channel: #**channel name**
Topic: #**channel name>topic name**

All URLs in Zulip are designed to be shareable. Copying the URL from the browser's address bar will work for all views, including searches.

This copies to your clipboard a permanent link to the message, displayed in its thread (i.e. topic view for messages in a channel). Viewing a topic via a message link will never mark messages as read.

These links will still work even when the message is moved to another topic or channel, or if its topic is resolved. Zulip uses the same permanent link syntax when quoting a message.

When you paste a message link into the compose box, it gets automatically formatted to be easy to read:

#**channel name>topic name@message ID**

When you send your message, the link will appear as #channel name>topic name@💬.

{start_tabs}

{tab|desktop-web}

{!message-actions-menu.md!}

  1. Click Copy link to message.

!!! tip ""

If using Zulip in a browser, you can also click on the timestamp
of a message, and copy the URL from your browser's address bar.

!!! tip ""

When you paste a message link into Zulip, it is automatically
formatted for you. You can paste as plain text if you prefer with
<kbd data-mac-following-key="⌥">Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>V</kbd>.

{end_tabs}

{start_tabs}

{tab|desktop-web}

{!topic-actions.md!}

  1. Click Copy link to topic.

!!! tip ""

If using Zulip in a browser, you can also click on a topic name,
and copy the URL from your browser's address bar.

{tab|mobile}

{!topic-long-press-menu.md!}

  1. Tap Copy link to topic.

{!topic-long-press-menu-tip.md!}

{end_tabs}

{start_tabs}

{tab|desktop-web}

{!channel-actions.md!}

  1. Click Copy link to channel.

{tab|mobile}

{!channel-long-press-menu.md!}

  1. Tap Copy link to channel.

{!channel-long-press-menu-tip.md!}

{end_tabs}