snapshot of https://github.com/mattermost/mattermost.git (master, 2026-09-16; blobs > 131072B omitted)

docs/main/end-user-guide/collaborate/organize-using-custom-user-groups.mdx

@@ -0,0 +1,87 @@
+---
+title: "Manage custom groups"
+---
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+<PlanAvailability slug="all-commercial" />
+
+Custom groups reduce noise and improve focus by notifying the right people in a channel at the right time, while maintaining transparency for all members in that channel. Custom user groups let you notify up to 256 users at a time rather than notifying users individually.
+
+For example, perhaps you want to @mention a cross-functional team about a bug fixes needed for an upcoming feature release, without notifying everyone else in the channel. Using a custom group notifies the cross-functional team immediately, while keeping important stakeholders in the loop on the status of the feature release.
+
+Or perhaps you want to add a group of users to a team and a channel. When you @mention a custom group in a channel, Mattermost prompts you to add anyone from that custom group who isn't already a channel and team member. See the [invite people to your workspace](/end-user-guide/collaborate/invite-people) documentation for details.
+
+Once a custom user group has been created, you can mention that group the same way you @mention another Mattermost member. See the [mention people in messages](/end-user-guide/collaborate/mention-people) documentation for details.
+
+<Note>
+
+- System admins need to enable this feature. See our [Mattermost Configuration Settings](/administration-guide/configure/site-configuration-settings#enable-custom-user-groups) documentation for details.
+- From Mattermost v7.2, system admins can limit who can manage custom user groups through the Custom Group Manager system admin role. See the [delegated granular administration](/administration-guide/onboard/delegated-granular-administration) documentation for details.
+- The ability to create custom user groups on mobile will be available in a future release. @mentions for custom user groups on mobile work the same as [LDAP-synced groups](/end-user-guide/collaborate/mention-people#groupname).
+
+</Note>
+
+## Create a custom group
+
+1.  Using Mattermost in a web browser or the desktop app, 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 **Create New User Group**.
+2.  Specify a name and mention. The mention is the handle you use to @mention a notification to the group. Group names must be unique across the Mattermost [workspace](/end-user-guide/end-user-guide-index). If a name is in use as a channel name, display name, or another custom group's name, it won't be available.
+3.  Search for and select members to add to the custom user group, then select **Create Group**.
+
+## Review group members
+
+From Mattermost v7.8, using Mattermost in a web browser or the desktop app, select a group mention in a thread to display a list of group members.
+
+## Manage custom user groups
+
+You can review and filter the list of custom groups, add people to an existing group, edit the group name or mention, leave the group, or archive the group.
+
+To manage a custom user group in a web browser or the desktop app, select **User Groups** from the Products menu, then select the group you want to modify.
+
+![Access tools to manage user groups.](/images/access-user-groups.png)
+
+### Review available groups
+
+Review a list of all available custom user groups, search for specific groups by name.
+
+<Tip>
+
+You can filter the list of groups to display only groups you're a member of, or only archived groups.
+
+</Tip>
+
+### Change name or mention
+
+1.  From the **More Actions** <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 to the right of any custom group, select **View Group**.
+
+> ![Access tools to manage your custom user groups.](/images/manage-user-groups.png)
+
+2.  From the **More Actions** <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, select **Edit Details**.
+
+> ![Edit details of a custom user group.](/images/edit-custom-group.png)
+
+3.  Update the **Name** or **Mention**, then select **Save Details**.
+
+### Add people
+
+1.  Select **Add People**.
+2.  Search for and select people to add to the group, then select **Add People**.
+
+### Remove people
+
+Hover over a member, then select the **Trash** icon to remove them from the group.
+
+### Join a group
+
+While viewing the members of a group, from the **More Actions** <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, select **Join Group**.
+
+### Leave a group
+
+From the **More Actions** <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, select **Leave Group**.
+
+### Archive group
+
+From the **More Actions** <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, select **Archive Group**. When you archive a custom user group, you won’t be able to mention the group’s handle or view its members. However, the group isn't deleted from the list, and all members remain in the group unless they're manually removed.
+
+### Unarchive group
+
+From Mattermost v9.1, you can restore an archived group. From the **More Actions** <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, filter the list of groups to show only archived groups. Select an archived group to view details about the group, if preferred, and then select **Restore Group**.