YouTrack Standalone 7.0 Help

Manage the Project Team

A Team incorporates user groups and users with a team role granted in its project.

A role is considered a team role if it has the Team flag. By default, YouTrack provides two team roles: Project Admin and Developer. You can create your own team roles by marking a role with the Team flag.

A project team is created automatically when a project is created. The project team contains contains:

  • The Project Admin — the user who created the project is assigned the Project Admin role in this project.
  • The [Project Name]-team group — the group of users assigned to the project. Members of this group are assigned the Developer role in this project.

Adding Users to the Project Team

  • Each user who is added to the team on the project settings page becomes a member of the [Project Name]-team group. Members of this group are added to the list of the Assignees for issues in the project.
  • If you add a user group to the project team, this group and all of its members are granted the Developer role in this project and are added to the list of Assignees for issues in the project.

Project Team vs Assignees

Project Team is not the list of project Assignees. 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. And like in 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.

Users or Groups with Team Roles in the Global Project

When you grant a role to a user or group in the Global project, this user or group is assigned this role in all projects in the system automatically. 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.

Default Settings for New Projects

When a user creates a project, the project team is automatically configured as follows:

  • The user who created the project is granted the Project Admin role.
  • This user is set as the Project Lead in the general project settings.
  • This user is added to the list of Assignees for issues in the project.
  • A new group named [Project Name]-team is created.
    This team is set as the project team and granted the Developer role in the new project.
    You are added to this team as a member.
  • The new group is added to the list of Assignees for issues in the project.
    Users who are later added to the group are automatically added to the list of Assignees.
  • Any user group with a global team role is added to the project team and the list of Assignees.
  • Any user with a global team role granted directly is added the the project team and the list of Assignees.

This default configuration can be modified manually at any time.

When You Upgrade from a Previous Version

When you upgrade an existing YouTrack installation to YouTrack 7.0, a project team is created for each existing project. This team includes the following users and groups:

  • Users or groups that are assigned the Developer or Project Admin role in the project.
  • Users or groups that are assigned the Developer or Project Admin role in the Global project.

The list of Assignees for issues in the project remains unchanged.

If you deleted either the default Developer or Project Admin role, YouTrack restores them during the upgrade and mark them as team roles.

Manually Configure the Project Team

When a project is created, a new group is set as the project team. The new team is granted the Developer role in the project. Add users to the team 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.

To add a user or group to the project team:

  1. Select a project on the Projects page.
  2. In the Team section of the page, click the + icon.
  3. Select the group or user you want to add to the team.

When you have finished adding members to the project team, check and configure the list of Assignees for issues in the project. For more information, see Manage Assignees.

To remove a user from the project team:

  1. In the Access Management section of the Administration menu, select Groups.
  2. Select the name of the project team from the groups list.
  3. Select the user you want to remove from the project.
  4. Click the Remove button.

In some cases, the user who you removed from the group still appears as a member of the project team. When this situation occurs, verify the following conditions:

Check the roles that are granted directly to this user and remove the team roles that are used by this project. Check the group membership for the user account and remove the user from any groups that are assigned a team role in this project. 

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

See Also

Last modified: 29 September 2016