Files
upstream-mattermost/docs/main/end-user-guide/collaborate/join-leave-channels.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

119 lines
5.4 KiB
Plaintext

---
title: "Join and leave channels"
---
import useBaseUrl from '@docusaurus/useBaseUrl';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
<PlanAvailability slug="all-commercial" />
## Join a channel
Channels are either **public** or **private**.
- **Public** channels are identified with a **Globe** <img src={useBaseUrl('/img/ui/globe_E805.svg')} alt="Public channels are identified with a Globe icon." className="theme-icon" /> icon. Anyone on the team can join a public channel.
- **Private** channels are typically used for sensitive topics, and are identified with a **Lock** <img src={useBaseUrl('/img/ui/lock-outline_F0341.svg')} alt="Private channels are identified with a Lock icon." className="theme-icon" /> icon. You must be invited to private channels by another channel member.
<Note>
To join a private channel, you need to be added to the channel by a member of that channel.
</Note>
To join a public channel:
<Tabs>
<TabItem value="web-desktop" label="Web/Desktop">
1. Select the **Add channels** button in the channel sidebar, then select **Browse Channels**.
> <img src={useBaseUrl('/images/add-channels-button.png')} width="400" alt="You can browse channels using the Add channels button" />
>
> Alternatively, you can select <img src={useBaseUrl('/img/ui/plus_F0415.svg')} alt="The Plus icon provides access to channel and direct message functionality." className="theme-icon" /> at the top of the channel sidebar, then select **Browse Channels**.
>
> ![You can browse available channels to join using the + option at the top of the channel sidebar.](/images/browse-channels.png)
2. Select **Join** next to the public channel you want to join.
> ![When browsing available channels, select the join option next to any channel to become a member.](/images/join-channels.png)
</TabItem>
<TabItem value="mobile" label="Mobile">
1. Tap <img src={useBaseUrl('/img/ui/plus_F0415.svg')} alt="The Plus icon provides access to channel and direct message functionality." className="theme-icon" /> located in the top right corner the app.
![Tap the plus icon to view additional options.](/images/mobile-select-a-channel.jpg)
2. Tap **Browse Channels**.
![Click on Browse Channels to view the list of public channels.](/images/create-channel-or-open-direct-message-on-mobile.jpg)
3. Tap the public channel you want to join.
![Tap on the public channel name that you want to join.](/images/mobile-browse-public-channels.jpg)
</TabItem>
</Tabs>
<Tip>
When you join channels, depending on the [channel actions configured](/end-user-guide/collaborate/create-channels), you may see a welcome message, and channels may be added to [a category in your channel sidebar](/end-user-guide/preferences/customize-your-channel-sidebar) automatically. Using Mattermost in a web browser or the desktop app, access **Channel Actions** from the channel name drop-down menu in the center pane to see what automatic actions have been configured.
</Tip>
See the following documentation to learn more about working with channels:
- [Create channels](/end-user-guide/collaborate/create-channels)
- [Browse channels](/end-user-guide/collaborate/browse-channels)
- [Customize your channel sidebar](/end-user-guide/preferences/customize-your-channel-sidebar)
## Leave a channel
When you leave a private channel, you must be re-added by another channel member to rejoin. You won't receive mention notifications from a channel if you're not a member of that channel.
<Note>
All users are added to the **Town Square** channel automatically. This means that users can't [archive](/end-user-guide/collaborate/archive-unarchive-channels#archive-a-channel), [unarchive](/end-user-guide/collaborate/archive-unarchive-channels#unarchive-a-channel), or leave the **Town Square** channel. However, [guests](/administration-guide/onboard/guest-accounts) who are manually invited to **Town Square** can leave the channel.
</Note>
<Tabs>
<TabItem value="web-desktop" label="Web/Desktop">
Select the channel name at the top of the center pane to access the drop-down menu, then select **Leave Channel**.
![You can use channel options available from the channel name to leave a channel.](/images/leave-channels.png)
</TabItem>
<TabItem value="mobile" label="Mobile">
1. Tap the channel you want to leave.
![Select the channel that you want to leave.](/images/mobile-select-a-channel.jpg)
2. Tap the **More** <img src={useBaseUrl('/img/ui/dots-vertical_F01D9.svg')} alt="Use the More icon in the top left corner to access Mattermost desktop apps customization settings." className="theme-icon" /> icon located in the top right corner of the app.
![Tap on More options to access available options for the channel you want to leave.](/images/mobile-select-more-options-for-a-channel.jpg)
3. Tap **Leave channel**.
![Tap on Leave channel to leave the current channel.](/images/mobile-select-view-info-for-a-channel.jpg)
4. Tap on **Leave** to confirm you choice.
![Tap on Leave to confirm your choice.](/images/mobile-confirm-leave-a-channel.jpg)
</TabItem>
</Tabs>
### Leave a public channel added by a membership policy
From Mattermost v11.8.0, when you leave a public channel you were added to by a membership policy, Mattermost asks you to confirm:
- Choosing **Leave channel** removes you from the channel.
- Choosing **Mute instead** keeps you in the channel and mutes its notifications.
If the channel is already muted, Mattermost shows **Cancel** and **Leave channel** instead of **Mute instead**.