Adds mobile instructions for copying a link to a message, topic, and channel via the long-press action menus. Clarifies some of the text around link formatting being in the web/desktop apps. Fixes some example links to redirect to headers on the page, and adds a missing period to a sentence.
5.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.
Link to a channel within Zulip
Channel links are automatically formatted as #channel name.
{start_tabs}
{tab|desktop-web}
{!start-composing.md!}
-
Type
#
followed by a few letters from the channel name. -
Pick the desired channel from the autocomplete.
-
Pick the top option from the autocomplete to link to the channel without selecting a topic.
!!! tip ""
To link to the channel you're composing to, type `#>`, and pick the
top option from the autocomplete.
{end_tabs}
In the web and desktop apps, when you paste a channel link into Zulip,
it's automatically formatted as #**channel name**
. You can use
Ctrl + Shift +
V 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.
{start_tabs}
{tab|desktop-web}
{!start-composing.md!}
-
Type
#
followed by a few letters from the channel name. -
Pick the desired channel from the autocomplete.
-
Type a few letters from the topic name.
-
Pick the desired topic from the autocomplete.
!!! tip ""
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.
{end_tabs}
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
Ctrl + Shift +
V 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.
!!! 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).
-
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 Ctrl + Shift + V 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 @ 💬.
{start_tabs}
{tab|desktop-web}
{!message-actions-menu.md!}
- 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.
{tab|mobile}
{!message-long-press-menu.md!}
- Tap Copy link to message.
{end_tabs}
In the web and desktop apps, when you paste a message link into Zulip, it is automatically formatted for you. You can use Ctrl + Shift + V to paste as plain text if you prefer.
Get a link to a specific topic
{start_tabs}
{tab|desktop-web}
{!topic-actions.md!}
- 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!}
- Tap Copy link to topic.
{end_tabs}
Get a link to a specific channel
{start_tabs}
{tab|desktop-web}
{!channel-actions.md!}
- Click Copy link to channel.
{tab|mobile}
{!channel-long-press-menu.md!}
- Tap Copy link to channel.
{end_tabs}