YouTrack Standalone 7.0 Help

Roles

On this page:

A role in YouTrack is a set of permissions. Roles are assigned to groups on a per-project basis within the selected project.

User accounts inherit roles based on their membership in a group, but can also have roles that are assigned directly.

You create and manage roles on the Administration > Roles page in YouTrack.

rolesMain

Default Roles

YouTrack provides five predefined default roles: System Admin, Project Admin, Developer, Reporter, and Observer.

If you want to create a custom set of permissions that are available to a group or user account, you can create new roles or edit predefined roles.

Create a New Role

If you want to provide specific access to a user or group, but do not want to modify any of the predefined roles, create a new role.

To create a new role:

  1. In the Access Management section of the Administration menu, select Roles.
  2. Click the Create Role button.
  3. Enter a name for the new role and click the Create Role button.
    roleNewRoleDialog

    — The settings page for the new role opens.

    roleNewRoleParameters
  4. Enter an optional description of the new role.
  5. Configure the set of available permissions by enabling or disabling specific permissions for the role.

That's it.

Once you have created and configured all of the roles that you want use, you can create or configure user groups and assign roles to them on a per-project basis.

Edit an Existing Role

If there is a specific permission you would like to enable for users who are already assigned a specific role, you can modify an existing role.

To edit an existing role:

  1. In the Access Management section of the Administration menu, select Roles.
  2. Select a role from the list.
  3. In the settings page, edit the name or description.
  4. Configure the set of available permissions by enabling or disabling specific permissions for the role.

    — All changes to permissions are applied and saved automatically.

Last modified: 29 September 2016