Manage user groups

import {TabItem, Tabs} from "@astrojs/starlight/components";

import FlattenedSteps from "../../components/FlattenedSteps.astro"; import NavigationSteps from "../../components/NavigationSteps.astro"; import ZulipNote from "../../components/ZulipNote.astro"; import ZulipTip from "../../components/ZulipTip.astro"; import AddUsersToAGroup from "../include/_AddUsersToAGroup.mdx"; import AdminOnly from "../include/_AdminOnly.mdx"; import CloudPaidPlansOnly from "../include/_CloudPaidPlansOnly.mdx"; import HowToCreateAUserGroup from "../include/_HowToCreateAUserGroup.mdx"; import RemoveUsersFromAGroup from "../include/_RemoveUsersFromAGroup.mdx"; import RightSidebarViewProfile from "../include/_RightSidebarViewProfile.mdx"; import SaveChanges from "../include/_SaveChanges.mdx"; import UserGroupsApplications from "../include/_UserGroupsApplications.mdx"; import UserGroupsIntro from "../include/_UserGroupsIntro.mdx"; import UserSubgroupsIntro from "../include/_UserSubgroupsIntro.mdx";

import ExpandBothDiagonalsIcon from "~icons/zulip-icon/expand-both-diagonals"; import UserGroupEditIcon from "~icons/zulip-icon/user-group-edit";

Create a user group

Change a user group's name or description

  1. Select a user group.
  1. Select the **General** tab on the right.
  1. Click the **change group info** (<UserGroupEditIcon />)
     icon to the right of the user group, and enter a new name or description.

  <SaveChanges />
</FlattenedSteps>

Configure group permissions

  1. Select a user group.
  1. Select the **General** tab on the right.
  1. Under **Group permissions**, configure **Who can administer this group**, **Who
     can mention this group**, **Who can add members to this group**, **Who can remove
     members from this group**, **Who can join this group**, and **Who can leave this group**.

  <SaveChanges />
</FlattenedSteps>

Add users to a group

Add user groups to a group

  1. Select a user group.
  1. Select the **Members** tab on the right.
  1. Under **Add members**, enter groups you want to add.
  1. Click **Add**.
</FlattenedSteps>

<ZulipTip>
  Click the <ExpandBothDiagonalsIcon /> icon
  on a user group pill to add all the members of the group, rather than the
  group itself.
</ZulipTip>

Remove user or group from a group

Review and remove permissions assigned to a group

You can review which permissions are assigned to a group, and remove permissions as needed. To add permissions, use the dedicated permissions management panel for your organization, or the channel or group you're adding permissions for.

  1. Select a user group.
  1. Select the **Permissions** tab on the right.
  1. Toggle the checkboxes next to any permissions you'd like to remove.
  1. Click **Save changes**.
</FlattenedSteps>

Configure who can create user groups

You can configure who can create groups in your organization. Guests can never create user groups, even if they belong to a group that has permissions to do so.

  1. Under **Group permissions**, configure **Who can create user groups**.

  <SaveChanges />
</FlattenedSteps>

Configure who can administer all user groups

You can configure who can administer all user groups in your organization. Guests can never administer user groups, even if they belong to a group that has permissions to do so.

In addition, you can give users permission to administer a specific group.

  1. Under **Group permissions**, configure **Who can administer all user groups**.

  <SaveChanges />
</FlattenedSteps>

Related articles

• User groups
• View group members
• Mention a user or group
• Create user groups
• Deactivate a user group
• Moving to Zulip
• User roles