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
110 lines
5.2 KiB
Plaintext
110 lines
5.2 KiB
Plaintext
---
|
|
title: "Communicate a channel's focus and scope"
|
|
---
|
|
import useBaseUrl from '@docusaurus/useBaseUrl';
|
|
import Tabs from '@theme/Tabs';
|
|
import TabItem from '@theme/TabItem';
|
|
|
|
<PlanAvailability slug="all-commercial" />
|
|
|
|
Every channel in Mattermost serves a purpose and exists for a reason. You can communicate a channel's focus and scope in 3 ways:
|
|
|
|
- a descriptive [channel name](#channel-name)
|
|
- a [channel purpose](#channel-purpose) description
|
|
- [channel header](#channel-header) details
|
|
|
|
## Channel name
|
|
|
|
You're prompted to provide a channel name when [creating a new channel in Mattermost](/end-user-guide/collaborate/create-channels). Channel names must be at least 2 characters, and can be up to 64 characters in length. See the [channel naming conventions](/end-user-guide/collaborate/channel-naming-conventions) documentation for additional details and guidance on why channel naming is important.
|
|
|
|
<Note>
|
|
|
|
[Some unicode characters](https://www.w3.org/TR/unicode-xml/#Charlist) aren't supported in channel names.
|
|
|
|
</Note>
|
|
|
|
Looking to rename an existing channel? See the [rename channels](/end-user-guide/collaborate/rename-channels) documentation for details.
|
|
|
|
## Channel purpose
|
|
|
|
You're prompted to provide an optional channel purpose description when [creating a channel](/end-user-guide/collaborate/create-channels) or [renaming a channel](/end-user-guide/collaborate/rename-channels). A channel purpose can be up to 250 characters in length, and is often used to help users decide whether to join that channel.
|
|
|
|
A channel's purpose is visible in the right pane when you 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 for the channel. Any member of a channel can change a channel's purpose description, unless the system admin has [disabled the ability to do so](/administration-guide/onboard/advanced-permissions).
|
|
|
|
<Tabs>
|
|
<TabItem value="web-desktop" label="Web/Desktop">
|
|
|
|

|
|
|
|
1. Select the channel name at the top of the center pane to access the drop-down menu, then select **Channel Settings**.
|
|
2. Enter or update the channel purpose.
|
|
3. Select **Save**.
|
|
|
|
</TabItem>
|
|
<TabItem value="mobile" label="Mobile">
|
|
|
|
1. Tap the channel you want to edit.
|
|
|
|

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

|
|
|
|
3. Tap **View info**.
|
|
|
|

|
|
|
|
4. Tap **Edit Channel**.
|
|
|
|

|
|
|
|
5. Type the new purpose of the channel and tap on **Save** to update the purpose.
|
|
|
|

|
|
|
|
</TabItem>
|
|
</Tabs>
|
|
|
|
|
|
## Channel header
|
|
|
|
A channel header is text that displays directly under a channel name at the top of the channel. Any channel member can change a channel header, unless the system admin has [disabled the ability to do so](/administration-guide/onboard/advanced-permissions)
|
|
|
|
A channel header can be up to 1024 characters in length, include Markdown formatting, and is often used to summarize the channel's focus or to provide links to frequently accessed documents, tools, or websites.
|
|
|
|
<Tabs>
|
|
<TabItem value="web-desktop" label="Web/Desktop">
|
|
|
|
1. Select the channel name at the top of the center pane to access the drop-down menu, then select **Channel Settings**.
|
|
2. Enter or change channel header details. You can use the same [Markdown formatting](/end-user-guide/collaborate/format-messages#use-markdown) in the channel header as you would when composing a message.
|
|
|
|

|
|
|
|
</TabItem>
|
|
<TabItem value="mobile" label="Mobile">
|
|
|
|
1. Tap the channel you want to edit.
|
|
|
|

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

|
|
|
|
3. Tap **View info**.
|
|
|
|

|
|
|
|
4. Tap **Edit Channel**.
|
|
|
|

|
|
|
|
5. Type the new header of the channel and tap on **Save** to update the header.
|
|
|
|

|
|
|
|
</TabItem>
|
|
</Tabs>
|
|
|