Roles
A role in YouTrack is a container for a set of permissions. Roles are assigned to users and groups on a per-project basis. Users and groups can also inherit roles based on their assignment to a project team.
You create and manage roles on the 
Administration > Roles page in YouTrack.
The Roles page features a search box that allows you to filter the list. YouTrack supports the following attributes in search queries that are applied as a filter on the Roles page.
Attribute | Value | Description |
|---|---|---|
id | value | Returns the role with the specified ID. |
key | <role key> | Returns the role with the specified key. |
name | <role name> | Returns the role with the specified name. |
permission | <permission> | Returns roles that contain the specified permission. |
has | permission | Returns roles that contain at least one permission. |
Sub-query | Description |
|---|---|
permission(key: permissionKey, service: service) | Returns roles that include the specified permission from the specified service. For example, to find roles that contain permission to create groups in the YouTrack Administration service, enter the following query on the Roles page: Note that each part of the permission key is indexed separately, so you can see relevant suggestions just by typing the name of the entity that the permission relates to. |
permission(service: service) | Returns roles that include any permission from the specified service. For example, to find roles that contain permission from the YouTrack Administration service, enterthe following query on the Roles page: |