Manage the Project Team

The project profile page displays a list of users who are assigned team roles in the project. The project team represents the users who actually work together on a project. The project team does not include other users, like administrators or supervisors, who have access to the project but do not take part in day-to-day development efforts.

What is a Project Team?

The project team is a collection of users and members of groups who are assigned a team role in a specific project plus the users and members of groups who are assigned a team role in the Global project. Each user has access to the project. The level of access is determined by the role that is assigned to each user or group.

When you create a project, YouTrack automatically creates a group with the name <project>-team. This group is granted the Developer role in the new project. This group contains:

• Individual users that you manually add to the team on the project profile page. These users are added as members to the <project>-team group. If the <project>-team group has been deleted, each user who is added to the team is granted the Developer role directly in the project.
• Each user that you add to the group on the Members tab of the Groups > <project>-team page. These users are also granted the Developer role in the project.

The following example shows the list of users who are members of the Team Tools-team group. As you can see, the list only shows users who have been added to the group.

The project team, however, isn't just a group in YouTrack. The team includes all other users who are assigned a team role that grants them access to the project. In addition to the members of the <project>-team group, the project team displays:

• The project lead. This user is assigned the Project Admin role directly in the project.
• Members of groups who are added to the project team. When you add a group to the project team, the group is granted the Developer role in the project. Members of this group inherit access to the project based on their membership in the group.
• Members of any group that is granted a team role in this project or in the Global project.
• Users with a team role in this project or in the Global project that is granted directly and not inherited from a group.

This example illustrates how the project team assembles the collection of users who have access to the project through various team role assignments.

The project team doesn't show every user who has access to the project. The following users are not shown on the list:

• Members of groups that are granted a role in this project or the Global project that is not marked as a team role.
• Users who are granted a role in this project or the Global project directly that is not marked as a team role.

The key factor that determines whether a user is shown as a member of the project team is the team flag that is used to mark a team role. For more information, see Team Roles.

Project Team vs Assignees

The project team is separate from the list of Assignees in the project. The project team consists of all users that have a team role in the project. These roles provide users with access to and grant permissions in the project. As with any real-life project, your project team can include members who are not assigned issues.

In YouTrack, assignees are taken from set of values for the Assignee field in an issue. This field references a list of users who can be assigned an issue in the project. It is also possible to add users to the list of assignees without adding them as a member to the project team. For more information, see Manage Assignees.

Team Roles in the Global Project

Users and groups with team roles in the Global are automatically assigned this role in all projects in the system. If there are any users or groups who are assigned a global team role when you create a project, these users and groups are added to the project team and to the list of assignees.

Add Users to the Project Team

You can add users to the project team directly on the project profile page.

To add users to the group and grant this role successfully, you must also have access to all of the permissions that are granted to this role. The easiest way to meet this requirement is when the Developer role is also assigned to your user account.

For a list of the permissions that are assigned to the Developer role by default, see Default Roles.

Remove Users from the Project Team

Removing users from the project team can be tricky. Each member of the project team can have access to a project directly, indirectly, or both. To remove a user from the project team, you need to remove any group membership or role assignment that grants access to the project.

Removing users from the project team almost always results in a permission loss. When you remove a team role from a user or group, you may need to restore vital permissions by replacing the team role assignment with another role that is not marked as a team role.

First, check the list of memberships in the Groups column. If the user in question is a member of the <project>-team group, start by removing the user from the group.

Return to the project profile page. If the user still appears in the project team, make a note of the remaining Role assignments for this user. Use the following table to investigate possible options for removing the user from the project team. If you are unable to perform any of these actions yourself, contact an administrator.

After you remove the user from the project team successfully, check the list of assignees for issues in the project and remove the user from the list, if necessary.