Creating and Managing User Groups

Edit page
Last modified: 26 April 2022

What is User Group in TeamCity

User groups help manage user accounts more efficiently:

  • Assign roles to all users included in the group at once: users get all the roles of the groups they belong to.

  • Set notification rules for all users in the group: all the notification rules defined for the group are treated as default notification rules for the users included in this group.

You can create as many user groups as you need, and each user group can include any number of user accounts and even other user groups. A user account (or a whole user group) can be included into several user groups as well.

"All Users" Group

All Users is a special user group that is always present in the system. The group contains all registered users and no user can be removed from the group. You can modify roles and notification rules of the All Users group to make them default for all the users in the system.

All the newly registered users get roles and notification rules inherited from the group.

The Guest User does not belong to the All Users group, so roles and notification rules can be managed for the user separately.

Creating New User Group

Open the Administration | Groups page and сlick Create new group. In the dialog, specify the group name. TeamCity will create an editable group key, which is a unique group identifier.

When creating a group, you can select the parent group(s) for it. All roles and notification rules configured for the parent group will be automatically assigned to the current group. To place the current group to the top level, deselect all groups in the list.

Editing Group Settings

To edit a group, click its name on the Groups tab. You can modify the group name and description as well as parent group(s), and change the list of users, roles and permissions, and notification settings for the group.

To delete a group, click Delete next to its name in the list. This action will only delete the group itself and won't affect the users of this group.

tip

The All Users group includes all users and cannot be deleted. However, you can modify its roles and notification settings.

The Roles tab allows you to view and edit (assign/unassign) default roles for the current group. These roles will be automatically assigned to all users in the group. Default roles for a user group are divided in two groups:

  • roles inherited from a parent group. Inherited roles can not be unassigned from the group.

  • roles assigned explicitly to the group

To assign a role for the current group explicitly, click the Assign role link. To view permissions granted to a role, click the View roles permissions link. You can also specify notification rules to be applied to all users in the current group.

To learn more about notification rules, refer to Subscribing to Notifications.