Manage user groups

User groups allow you to mention multiple users at once. When you mention a user group, everyone in the group is notified as if they were personally mentioned. For example, you may choose to create user groups for teams in your organization.

Create a user group

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

  1. Click on the gear () icon in the upper right corner of the web or desktop app.

  2. Select Group settings.

  3. Click Create user group on the right, or click the plus () icon in the upper right.

  4. Fill out the requested information, and click Continue to add members.

  5. Add users who will be members of the group, and click Create.

Note: You will only see the Create user group button if you have permission to create user groups.

Change a user group's name or description

  1. Click on the gear () icon in the upper right corner of the web or desktop app.

  2. Select Group settings.

  3. Click All groups in the upper left.

  4. Select a user group.

  5. Select the General tab on the right.

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

  7. Click Save changes.

Configure who can mention a user group

  1. Click on the gear () icon in the upper right corner of the web or desktop app.

  2. Select Group settings.

  3. Click All groups in the upper left.

  4. Select a user group.

  5. Select the General tab on the right.

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

  7. Click Save changes.

Add users to a user group

  1. Click on the gear () icon in the upper right corner of the web or desktop app.

  2. Select Group settings.

  3. Click All groups in the upper left.

  4. Select a user group.

  5. Select the Members tab on the right.

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

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

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

Remove users from a user group

  1. Click on the gear () icon in the upper right corner of the web or desktop app.

  2. Select Group settings.

  3. Click All groups in the upper left.

  4. Select a user group.

  5. Select the Members tab on the right.

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

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

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

Deactivate a user group

  1. Click on the gear () icon in the upper right corner of the web or desktop app.

  2. Select Group settings.

  3. Click All groups in the upper left.

  4. Select a user group.

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

  6. Click Confirm.

Configure who can create user groups

This feature is only available to organization owners and administrators.

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.

  1. Go to Organization permissions.

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

  3. Click Save changes.

Configure who can manage user groups

This feature is only available to organization owners and administrators.

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

Note that administrators and moderators can modify any user group, while other organization members can only modify user groups to which they belong. Guests cannot modify user groups.

  1. Go to Organization permissions.

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

  3. Click Save changes.