Files
zulip/help/link-to-a-message-or-conversation.md
Alya Abbott 5ee97a48a6 help: Document permanent topic links.
Also note that channel links are permanent.
2025-02-14 15:46:25 -08:00

4.8 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.

Channel links are automatically formatted as #channel name.

{start_tabs}

{!start-composing.md!}

  1. Type # followed by a few letters from the channel name.

  2. Pick the desired channel from the autocomplete.

  3. Pick the top option from the autocomplete to link to the channel without selecting a topic.

!!! tip ""

You can create a channel link manually by typing `#**channel name**`.

{end_tabs}

When you paste a channel link into Zulip, it's automatically formatted as #**channel name**. You can paste as plain text if you prefer with Ctrl + Shift + V.

Topic links are automatically formatted as #channel > topic.

{start_tabs}

{!start-composing.md!}

  1. Type # followed by a few letters from the channel name.

  2. Pick the desired channel from the autocomplete.

  3. Type a few letters from the topic name.

  4. Pick the desired topic from the autocomplete.

!!! tip ""

You can create a topic link manually by typing `#**channel name>topic name**`.

{end_tabs}

When you paste a topic link into Zulip, it's automatically formatted as #**channel name>topic name**. You can paste as plain text if you prefer with Ctrl + Shift + V.

All URLs in Zulip are designed to be shareable, including:

  • Links to messages, topics, and channels.
  • Search URLs, though note that personal filters (e.g., is:followed) will be applied according to the user who's viewing the URL.

In addition, links to messages, topics, and channels are permanent:

!!! tip ""

When some messages are [moved out of a
topic](/help/move-content-to-another-topic) and others are left in place,
links to that topic will follow the location of the message whose ID is
encoded in the topic URL (usually the first or last message in the topic).

This copies to your clipboard a permanent link to the message, displayed in the context of its conversation. To preserve your reading status, messages won't be automatically marked as read when you view a conversation via a message link.

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}