Link to a message or conversation

import {Steps, TabItem, Tabs} from "@astrojs/starlight/components";

import FlattenedSteps from "../../components/FlattenedSteps.astro"; import KeyboardTip from "../../components/KeyboardTip.astro"; import ZulipNote from "../../components/ZulipNote.astro"; import ZulipTip from "../../components/ZulipTip.astro"; import ChannelActions from "../include/_ChannelActions.mdx"; import ChannelLongPressMenu from "../include/_ChannelLongPressMenu.mdx"; import MessageActionsMenu from "../include/_MessageActionsMenu.mdx"; import MessageLongPressMenu from "../include/_MessageLongPressMenu.mdx"; import StartComposing from "../include/_StartComposing.mdx"; import TopicActions from "../include/_TopicActions.mdx"; import TopicLongPressMenu from "../include/_TopicLongPressMenu.mdx";

import LinkIcon from "~icons/zulip-icon/link"

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.

Link to a channel within Zulip

Channel links are automatically formatted as #channel name.

  1. Type `#` followed by a few letters from the channel name.
  1. Pick the desired channel from the autocomplete.
  1. Pick the top option from the autocomplete to link to the channel without
     selecting a topic.
</FlattenedSteps>

<ZulipTip>
  To link to the channel you're composing to, type `#>`, and pick the
  top option from the autocomplete.
</ZulipTip>

In the web and desktop apps, when you paste a channel link into Zulip, it's automatically formatted as #**channel name**. You can use <kbd data-mac-following-key="⌥">Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>V</kbd> to paste as plain text if you prefer.

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

Link to a topic within Zulip

Topic links are automatically formatted as #channel > topic.

  1. Type `#` followed by a few letters from the channel name.
  1. Pick the desired channel from the autocomplete.
  1. Type a few letters from the topic name.
  1. Pick the desired topic from the autocomplete.
</FlattenedSteps>

<ZulipTip>
  To link to a topic in the channel you're composing to, type `#>`
  followed by a few letters from the topic name, and pick the desired
  topic from the autocomplete.
</ZulipTip>

In the web and desktop apps, when you paste a topic link into Zulip, it's automatically formatted as #**channel name>topic name**. You can use <kbd data-mac-following-key="⌥">Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>V</kbd> to paste as plain text if you prefer.

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

Link to Zulip from anywhere

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:

• Message 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.
• Topic links will still work even when the topic is renamed, moved to another channel, or resolved. <ZulipTip> When some messages are moved out of a 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). </ZulipTip>
• Channel links will still work even when a channel is renamed or archived.

When you copy a Zulip link in the web and desktop apps, and paste it anywhere that accepts HTML formatting (e.g., your email, GitHub, docs, etc.), the link will be formatted as it would be in Zulip (e.g., #channel > topic). To paste the plain URL, you can paste without formatting (likely <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>V</kbd> in your browser).

Get a link to a specific message

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.

In the web and desktop apps, 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 > topic @ 💬.

  1. Click **Copy link to message**.
</FlattenedSteps>

<KeyboardTip>
  You can also use <kbd>L</kbd> to copy a link to the selected message.
</KeyboardTip>

<ZulipTip>
  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.
</ZulipTip>

  1. Tap **Copy link to message**.
</FlattenedSteps>

In the web and desktop apps, when you paste a message link into Zulip, it is automatically formatted for you. You can use <kbd data-mac-following-key="⌥">Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>V</kbd> to paste as plain text if you prefer.

Get a link to a specific topic

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

  1. Click **Copy link to topic**.
</FlattenedSteps>

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

  1. Tap **Copy link to topic**.
</FlattenedSteps>

Get a link to a specific channel

  1. Click **Copy link to channel**.
</FlattenedSteps>

  1. Tap **Copy link to channel**.
</FlattenedSteps>

Related articles

• Add a custom linkifier
• Message formatting
• Linking to your organization
• Pin information