Files
upstream-mattermost/docs/main/end-user-guide/collaborate/share-links.mdx
upstream-mirror 240db4e2a7
Some checks failed
Server CI / Postgres (shard 0) (push) Has been skipped
Server CI / Postgres (shard 3) (push) Has been skipped
BuildEnv Docker Image / build-image (push) Failing after 4s
BuildEnv Docker Image / build-image-fips (push) Failing after 4s
Migration Review & Release Notes / Generate migration review & release notes (push) Failing after 3s
Server CI / Build Environment (push) Failing after 3s
Server CI / Postgres (shard 1) (push) Has been skipped
Tools CI / check-style (mattermost-govet) (push) Failing after 4s
Server CI / Postgres (shard 2) (push) Has been skipped
Tools CI / check-style (mmgotool) (push) Failing after 3s
Server CI / Elasticsearch v8 Compatibility (push) Has been skipped
Server CI / OpenSearch v2 Compatibility (push) Has been skipped
Server CI / Postgres FIPS (shard 0) (push) Has been skipped
Tools CI / Test (mattermost-govet) (push) Failing after 3s
Server CI / Postgres FIPS (shard 1) (push) Has been skipped
Server CI / Postgres FIPS (shard 2) (push) Has been skipped
Tools CI / Test (mmgotool) (push) Failing after 3s
Server CI / Postgres FIPS (shard 3) (push) Has been skipped
Server CI / Run mmctl tests (push) Has been skipped
Server CI / Run mmctl tests (FIPS) (push) Has been skipped
Server CI / Merge Postgres Test Results (push) Has been skipped
Server CI / Merge Postgres FIPS Test Results (push) Has been skipped
Server CI / Check backport migrations (push) Has been skipped
Server CI / Check generated files (push) Has been skipped
Server CI / check-style (push) Has been skipped
Server CI / Vet API (push) Has been skipped
Server CI / Build mattermost server app (push) Has been skipped
Server CI / Server CI Complete (push) Failing after 2s
Server CI / Server CI Artifacts (push) Has been skipped
Server CI / Sentry Upload (push) Has been skipped
Server CI / Server CI Report (push) Failing after 5m1s
Server CI Nightly Race / Race Detector (push) Has been skipped
CodeQL / Analyze (go) (push) Has been cancelled
CodeQL / Analyze (javascript) (push) Has been cancelled
Webapp CI Cache Warm / Warm Webapp node_modules Cache (push) Has been cancelled
E2E CI Cache Warm / Warm E2E npm Registry Cache (push) Has been cancelled
API / build (push) Has been cancelled
Web App CI / check-types (push) Has been cancelled
Web App CI / check-lint (push) Has been cancelled
Web App CI / check-i18n (push) Has been cancelled
Web App CI / check-external-links (push) Has been cancelled
Web App CI / test (platform) (push) Has been cancelled
Web App CI / test (mattermost-redux) (push) Has been cancelled
Web App CI / test (channels shard 1/4) (push) Has been cancelled
Web App CI / test (channels shard 2/4) (push) Has been cancelled
Web App CI / test (channels shard 3/4) (push) Has been cancelled
Web App CI / test (channels shard 4/4) (push) Has been cancelled
Web App CI / upload-coverage (push) Has been cancelled
Web App CI / build (push) Has been cancelled
YAML Lint / yamllint (push) Has been cancelled
Push mirrored docker images / cd/Push mirrored docker images (push) Has been cancelled
docs-cd / Build and deploy docs (push) Has been cancelled
Docs CI / build (push) Has been cancelled
E2E Cache Warm: Cypress deps / Warm Cypress deps cache (push) Has been cancelled
Scorecards supply-chain security / Scorecard analysis (push) Has been cancelled
Server CI Weekly / Postgres FIPS (push) Has been skipped
Server CI Weekly / Run mmctl tests (FIPS) (push) Has been skipped
Server CI Weekly / Postgres with binary parameters (push) Has been skipped
Server CI Weekly / Build Environment (push) Failing after 1s
Server CI Cache Warm / Warm Go Module and Build Cache (push) Failing after 2s
Server CI Nightly Race / Build Environment (push) Failing after 1s
snapshot of https://github.com/mattermost/mattermost.git (master, 2026-09-16; blobs > 131072B omitted)
2026-09-16 00:29:55 +05:00

78 lines
4.4 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: "Share links to channels and messages"
---
import useBaseUrl from '@docusaurus/useBaseUrl';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
<PlanAvailability slug="all-commercial" />
You can share links to Mattermost [channels](#share-channel-links) and [messages](#share-message-links) with other Mattermost users.
## Share channel links
Sharing channel links makes it easy for others to find and join channels. To share a link to a channel, type `~` into the message text box, then select the channel you want to link to. If you're a member of multiple teams, only channels for the current team are listed.
<Tip>
Alternatively, you can select the **View info** <img src={useBaseUrl('/img/ui/information-outline_F02FD.svg')} alt="Use the Channel Info icon to access additional channel management options." className="theme-icon" /> icon in the top right corner of the screen to access additional channel management options, including a **Copy Link** option you can share with others.
</Tip>
## Share message links
<Tabs>
<TabItem value="web-desktop" label="Web/Desktop">
Sharing message links displays a preview of the message in the post. To share links to messages in Mattermost, select the **More** <img src={useBaseUrl('/img/ui/dots-horizontal_F01D8.svg')} alt="Use the More icon to access additional message options." className="theme-icon" /> icon next to a message, then select **Copy Link**.
![When you hover over messages, you can access more message options from the More icon.](/images/message-more.png)
![You can share links to messages with others using the More option.](/images/copy-link.png)
Paste the link into a message to share the image link with others. Sharing links to messages generates a preview of the message.
![Mattermost generates previews of links shared in Channels.](/images/permalink-previews.png)
<Tip>
- You can also hover over an image and select the <img src={useBaseUrl('/img/ui/link-variant_F0339.svg')} alt="Use the Copy Link icon to copy the public URL link for an image in a message." className="theme-icon" /> icon in the top right corner.
- The timestamp next to the username of any message is also a permanent link to that conversation.
</Tip>
</TabItem>
<TabItem value="mobile" label="Mobile">
Long press a message, and then tap **Copy Link** to copy the link to the clipboard. Long press to paste the link as a message or reply. From mobile v2.23, sharing links to messages generates a preview of the message.
![Tap and hold on a message to access the available options.](/images/mobile-copy-a-link-to-the-message.gif)
</TabItem>
</Tabs>
<Note>
- Message previews respect channel membership permissions, so they’re only visible to users who have access to the original message. If the link is to a message in a public channel, any member of the team can see the message preview. If the link is to a message in a private channel or direct message, only members in that channel can see the message preview.
- If you're unable to share links, contact your Mattermost system admin for assistance. An [SSL certificate (or a self-signed certificate)](/administration-guide/onboard/ssl-client-certificate) may be required for this functionality to work.
</Note>
## Deep links
Deep links are a powerful feature in Mattermost that allow you to create direct links to specific teams, channels, messages, or threads. These links can be used to quickly navigate to important content within Mattermost, enhancing collaboration and efficiency.
Deep links can also be used, in combination with bots, scripts, and integrations, to trigger specific actions within Mattermost.
From Mattermost v10.11, [channel bookmarks](/end-user-guide/collaborate/manage-channel-bookmarks) containing `mattermost://` open directly in the desktop app using deep linking. This turns channel bookmarks into one-click shortcuts that enable you jump straight to key assets in Mattermost quickly and easily.
### Format deep links
Deep links must be formatted in Mattermost as follows:
- Deep link to a team: `mattermost://<your-Mattermost-server-URL>/<team-name>`
- Deep link to a channel: `mattermost://<your-Mattermost-server-URL>/<team-name>/channels/<channel-name>`
- Deep link to a channel message or thread: `mattermost://<your-Mattermost-server-URL>/<team-name>/pl/<post-id>`
- Deep link to a direct message: `mattermost://<your-Mattermost-server-URL>/<team-name>/messages/@<user-name>`