Files
zulip/help/manage-user-groups.md
Shubham Padia c9d5276031 user_groups: Set can_manage_all_groups to administrator group.
Earlier we use to restrict admins, moderators or members of a group to
manage that group if they were part of the realm wide
`can_manage_all_groups`. We will not do that anymore and even
non-members of a group regardless of role can manage a group if they are
part of `can_manage_all_groups`.

See
https://chat.zulip.org/#narrow/stream/101-design/topic/Group.20add.20members.20dropdown/near/1952902
to check more about the migration plan for which this is the last step.
2024-10-11 16:31:18 -07:00

3.2 KiB

Manage user groups

{!user-groups-intro.md!}

Create a user group

!!! tip ""

You can modify the group's name, description, and other settings after it
has been created.

{!how-to-create-a-user-group.md!}

Change a user group's name or description

{start_tabs}

{tab|desktop-web}

{relative|group|all}

  1. Select a user group.

  2. Select the General tab on the right.

  3. Click the pencil () icon to the right of the user group, and enter a new name or description.

{!save-changes.md!}

{end_tabs}

Configure who can mention a user group

{start_tabs}

{tab|desktop-web}

{relative|group|all}

  1. Select a user group.

  2. Select the General tab on the right.

  3. Under Group permissions, configure Who can mention this group.

{!save-changes.md!}

{end_tabs}

Add users to a user group

{start_tabs}

{tab|desktop-web}

{relative|group|all}

  1. Select a user group.

  2. Select the Members tab on the right.

  3. Under Add members, enter a name or email address. The typeahead will only include users who aren't already members of the group.

  4. Click Add. Zulip will notify everyone who is added to the group.

!!! tip ""

To add users in bulk, you can copy members from an
existing channel or user group.

{end_tabs}

Remove users from a user group

{start_tabs}

{tab|desktop-web}

{relative|group|all}

  1. Select a user group.

  2. Select the Members tab on the right.

  3. Under Members, find the user you would like to remove.

  4. Click the Remove button in that row. Zulip will notify everyone who is removed from the group.

!!! warn ""

**Note**: If you remove yourself from a user group, you
may no longer have permission to modify the user group.

{end_tabs}

Deactivate a user group

{start_tabs}

{tab|desktop-web}

{relative|group|all}

  1. Select a user group.

  2. Click the Deactivate group () button in the upper right corner of the user group settings panel.

  3. Click Confirm.

{end_tabs}

Configure who can create user groups

{!admin-only.md!}

By default, all members in a Zulip organization can create user groups. However, you can restrict that ability to specific roles. Note that guests cannot create user groups.

{start_tabs}

{tab|desktop-web}

{settings_tab|organization-permissions}

  1. Under Other permissions, configure Who can create user groups.

{!save-changes.md!}

{end_tabs}

Configure who can manage user groups

{!admin-only.md!}

By default, owners in a Zulip organization can manage user groups. However, you can expand that ability to specific roles.

Guests cannot modify user groups.

{start_tabs}

{tab|desktop-web}

{settings_tab|organization-permissions}

  1. Under Other permissions, configure Who can manage user groups.

{!save-changes.md!}

{end_tabs}