zulip/help/manage-user-groups.md

Manage user groups

{!cloud-paid-plans-only.md!}

{!user-groups-intro.md!}

{!user-groups-applications.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 change group info () icon to the right of the user group, and enter a new name or description.

{!save-changes.md!}

{end_tabs}

Configure group permissions

!!! warn ""

Guests can never administer user groups, add anyone else to a group, or remove
anyone else from a group, even if they belong to a group that has permissions
to do so.

!!! tip ""

Users who can add members to a group can always join the 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 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.

{!save-changes.md!}

{end_tabs}

Add users to a group

{!add-users-to-a-group.md!}

Add user groups to a group

{!user-subgroups-intro.md!}

{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 groups you want to add.

4. Click Add.

!!! tip ""

Click the <i class="zulip-icon zulip-icon-expand-both-diagonals"></i> icon
on a user group pill to add all the members of the group, rather than the
group itself.

{end_tabs}

Remove user or group from a group

{start_tabs}

{tab|via-group-settings}

{relative|group|all}

1. Select a user group.

2. Select the Members tab on the right.

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

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

{tab|via-user-profile}

{!right-sidebar-view-profile.md!}

1. Select the User groups tab.

2. Find the group you would like to remove the user from.

3. Click the Remove () icon in that row.

{end_tabs}

Review and remove permissions assigned to a group

You can review which permissions are assigned to a group, and remove permissions as needed.

{start_tabs}

{tab|desktop-web}

{relative|group|all}

1. Select a user group.

2. Select the Permissions tab on the right.

3. Toggle the checkboxes next to any permissions you'd like to remove.

4. Click Save changes.

{end_tabs}

Configure who can create user groups

{!admin-only.md!}

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.

{start_tabs}

{tab|desktop-web}

{settings_tab|organization-permissions}

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

{!save-changes.md!}

{end_tabs}

Configure who can administer all user groups

{!admin-only.md!}

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.

{start_tabs}

{tab|desktop-web}

{settings_tab|organization-permissions}

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

{!save-changes.md!}

{end_tabs}

Related articles

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