YouTrack Server 2025.2 Help

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.

Roles list

Roles

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.

Supported sub-queries

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:

permission(key: {jetbrains.jetpass.group-create}, service: {YouTrack Administration})

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:

permission(service: {YouTrack Administration})
Last modified: 01 April 2025