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
177 lines
8.3 KiB
Plaintext
177 lines
8.3 KiB
Plaintext
---
|
|
title: "Channel naming conventions"
|
|
---
|
|
<PlanAvailability slug="all-commercial" />
|
|
|
|
All organizations are different and have different communication needs. The importance of organizing your conversations increases as your user base grows. The following are ideas for how you might want to name, group, and structure your channels. If you change your mind about a channel's name, you can [rename it](/end-user-guide/collaborate/rename-channels).
|
|
|
|
## Basic structure
|
|
|
|
- Channel names appear in menus where users select which conversations to join.
|
|
- Channel names are unique.
|
|
- Channel names have a 64-character limit to ensure readability on both desktop and mobile devices.
|
|
- An additional 1024 characters are available for describing the channel's focus in the channel header and channel information pane.
|
|
- An additional 128 characters are available for a **Channel Purpose** that's visible in the channel header and the channel information pane.
|
|
- Channel names can include standard Unicode emojis that are universally supported emojis that look the same (or similar) across platforms. Specify a Unicode emoji by positioning your cursor in the channel **Display Name** field and accessing the Unicode emoji picker for your operating system, as follows:
|
|
|
|
> - On Windows press <kbd>Windows</kbd> + <kbd>.</kbd> or <kbd>;</kbd> to open the Unicode emoji picker.
|
|
> - On macOS, press <kbd>Ctrl</kbd> + <kbd>⌘</kbd> + <kbd>Space</kbd> to open the Unicode emoji picker.
|
|
|
|
We recommend prefixing channel names with emojis for the following reasons:
|
|
|
|
> - Emojis can make it easier for users to quickly identify and manage channels, particularly in large workspaces with many channels.
|
|
> - Sharing the same emoji across channels related to a specific category or function helps maintain organization and consistency across the workspace.
|
|
> - Making channels more visually distinct with emojis helps users find the channels they need more quickly and easily at a glance, reducing the time spent searching for the right channel.
|
|
> - New users can quickly understand the purpose of various channels based on their emoji prefixes without needing extensive explanations.
|
|
> - As users grasp channel structure through emojis, the time and effort needed to train new members on navigating the workspace is reduced.
|
|
> - A well-organized and visually appealing workspace can encourage users to participate more actively, which can lead to more effective communication and collaboration.
|
|
|
|
## Scope channel names
|
|
|
|
It's natural to start with broadly defined channels and let them divide into narrower topics as discussions progress.
|
|
|
|
For example, you might begin with a general "Marketing" channel. As conversations progress, you might divide that channel into: "Marketing: Website", "Marketing: Social Media", "Marketing: General".
|
|
|
|
<Tip>
|
|
|
|
Use colons to separate sections of channel names, rather than `-` or `>` which require more spaces to display.
|
|
|
|
</Tip>
|
|
|
|
As the organization grows, disciplines might split across business units, products and geographies, with channel names like "US: Marketing" and "UK: Marketing".
|
|
|
|
<Tip>
|
|
|
|
If you need to shorten country names, use standard [2-letter country codes](https://www.nationsonline.org/oneworld/country_code_list.htm).
|
|
|
|
</Tip>
|
|
|
|
You can combine the hierarchies, with formats like `[SUB-TEAM]: [TOPIC]: [SUB-TOPIC]`. For example: `US: Mrkt: Website` and `UK: Mrkt: Social Media`.
|
|
|
|
<Tip>
|
|
|
|
Shorten words, particularly categories, by removing vowels, endings, and redundant letter sounds. Example: Turn "Marketing" into "Mrkt", and "Project" into "Prjt".
|
|
|
|
</Tip>
|
|
|
|
Good naming can take a team up to several thousand channels without significant confusion. Eventually every organization hits a limit and an additional team might need to be created on the server to accommodate the large number of channels. Keeping names clear and short lets users navigate large collections of channels quickly.
|
|
|
|
Here are different navigation options and types of channels to consider.
|
|
|
|
### Navigate channels using the keyboard
|
|
|
|
Keyboard shortcuts allow users to jump between channels. See the [keyboard shortcuts](/end-user-guide/collaborate/keyboard-shortcuts) documentation for all available keyboard shortcuts.
|
|
|
|
### Topic channels
|
|
|
|
Topics are broad categories for organizing discussions. Topics are similar to how a user might create a folder for organizing emails or documents. Examples: Recruiting, Interviews, Legal Reviews, Documentation.
|
|
|
|
Users can join and leave topic-based channels, as well as add colleagues to have topic-based discussions.
|
|
|
|
As teams get larger and the number of channels increase, you may start naming topics in a hierarchy to make them easier to find. Examples: Legal: Trademarks, Legal: Contracts, Legal: Licensing.
|
|
|
|
### Meeting channels
|
|
|
|
Meeting channels are often used to organize regular meetings. Members can add topics as messages to be discussed during the regular meeting time. Examples: Monday Sales Update, All Hands Meeting.
|
|
|
|
There are three built-in features to make meetings easier:
|
|
|
|
1. Numbered agenda items in title text
|
|
|
|
You can number and format messages as agenda items to discuss for the next meeting.
|
|
|
|
<Tip>
|
|
|
|
Try pasting the following as an example in a channel designated for meetings:
|
|
|
|
#### 1) Agenda item example
|
|
#### Commentary about agenda item to be discussed.
|
|
|
|
</Tip>
|
|
|
|
2. Threaded messaging
|
|
|
|
On an agenda item message, you can select `[...] > Reply` to leave comments about an agenda item before or after a meeting to extended discussion.
|
|
|
|
3. Header links
|
|
|
|
When meeting remotely, add persistent links to your video or audio conferencing solution, like Zoom, Google Hangouts, or BlueJeans in the channel header. See our [documentation](/end-user-guide/collaborate/channel-header-purpose) to learn more about working with channel headers.
|
|
|
|
When it's time to meet, your team can select the conference link to connect.
|
|
|
|
### Sub-team channels
|
|
|
|
Sub-teams can include people from the same discipline, project teams, people with the same manager or other groups brought together for a shared purpose. Examples: Developers, Marketers, Offsite Organizing Committee, SusanK's Directs
|
|
|
|
As sub-teams grow beyond a manageable size for one channel, they can sub-divide. Examples: US: Developers, UK: Developers, SusanK's Directs, SusanK's Extended Directs.
|
|
|
|
### Project channels
|
|
|
|
Project channels discuss how groups of people come together to achieve specific outcomes. Examples: Logo Design, Localization, Product Launch.
|
|
|
|
Projects are often private channels rather than public channels and are used to organize a small team around a project brought up in a larger channel. The Project Channel is used to do detailed work, and updates are typically communicated back to larger channels.
|
|
|
|
### Location channels
|
|
|
|
If your teams are in different buildings, cities or regions, you can create Location channels to help people coordinate meetings and get-togethers. Examples: Building 10, Palo Alto, Toronto, Delaware.
|
|
|
|
This helps share announcements and discussions relevant to only those locations.
|
|
|
|
### Data channels
|
|
|
|
Data channels allow automatic integration. Information like new or updated support tickets or bug reports, Twitter updates or mentions of your company name in the news can all be made available in channels your team chooses to monitor. There is a wide array of options. Examples: Bugs, Support Tickets, Twitter, News Mentions.
|
|
|
|
People might use these channels like a daily newspaper, reading about everything that's happened in the last day, while other configurations allow notifications to alert only when their username or certain key words are mentioned.
|
|
|
|
## Channel naming examples
|
|
|
|
Here is an example of what a marketer's channels might look like in a small team:
|
|
|
|
CHANNELS
|
|
|
|
- Recruiting
|
|
- Interviews
|
|
- Marketing
|
|
- Sales
|
|
- All Hands Meeting
|
|
- Town Square
|
|
- Off-Topic
|
|
|
|
PRIVATE CHANNELS
|
|
|
|
- Website
|
|
- Twitter Marketing
|
|
- Logo Design
|
|
|
|
DIRECT MESSAGES
|
|
|
|
- \[Sales People\]
|
|
- \[Marketers\]
|
|
- \[Recruiter\]
|
|
- \[Manager\]
|
|
|
|
Here's an example of what a marketer's channels might look like if she was working in the Palo Alto, California office of a large enterprise, working on a product called "Pontoon":
|
|
|
|
CHANNELS
|
|
|
|
- Geo: PA: Recruiting
|
|
- Geo: PA: Interviews
|
|
- US: Mrkt: General
|
|
- US: Sales: West Coast
|
|
- US: All Hands
|
|
- Town Square
|
|
- Off-Topic
|
|
|
|
PRIVATE CHANNELS
|
|
|
|
- Pontoon: Mkrt: Website
|
|
- Pontoon: Mkrt: Twitter
|
|
- Pontoon: Mkrt: Logo Design
|
|
|
|
DIRECT MESSAGES
|
|
|
|
- \[West Coast Sales People\]
|
|
- \[Marketing Peers\]
|
|
- \[Recruiter for PA office\]
|
|
- \[Manager\]
|