mirror of
				https://github.com/zulip/zulip.git
				synced 2025-11-03 21:43:21 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			200 lines
		
	
	
		
			4.0 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			200 lines
		
	
	
		
			4.0 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
# 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.
 | 
						|
 | 
						|
1. Select the **General** tab on the right.
 | 
						|
 | 
						|
1. Click the **pencil** (<i class="fa fa-pencil"></i>) 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.
 | 
						|
 | 
						|
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**.
 | 
						|
 | 
						|
{!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.
 | 
						|
 | 
						|
1. Select the **Members** tab on the right.
 | 
						|
 | 
						|
1. Under **Add members**, enter groups you want to add.
 | 
						|
 | 
						|
1. 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.
 | 
						|
 | 
						|
1. Select the **Members** tab on the right.
 | 
						|
 | 
						|
1. Under **Members**, find the user or group you would like to remove.
 | 
						|
 | 
						|
1. Click the **Remove** button 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.
 | 
						|
 | 
						|
1. Find the group you would like to remove the user from.
 | 
						|
 | 
						|
1. Click the **Remove** button 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.
 | 
						|
 | 
						|
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**.
 | 
						|
 | 
						|
{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 **Other 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](#configure-group-permissions) to administer a specific
 | 
						|
group.
 | 
						|
 | 
						|
{start_tabs}
 | 
						|
 | 
						|
{tab|desktop-web}
 | 
						|
 | 
						|
{settings_tab|organization-permissions}
 | 
						|
 | 
						|
1. Under **Other permissions**, configure **Who can administer all user groups**.
 | 
						|
 | 
						|
{!save-changes.md!}
 | 
						|
 | 
						|
{end_tabs}
 | 
						|
 | 
						|
## Related articles
 | 
						|
 | 
						|
* [User groups](/help/user-groups)
 | 
						|
* [View group members](/help/view-group-members)
 | 
						|
* [Mention a user or group](/help/mention-a-user-or-group)
 | 
						|
* [Create user groups](/help/create-user-groups)
 | 
						|
* [Deactivate a user group](/help/deactivate-a-user-group)
 | 
						|
* [Moving to Zulip](/help/moving-to-zulip)
 | 
						|
* [User roles](/help/user-roles)
 |