YouTrack Server 2025.1 Help

Users

In the Users section, you can manage accounts for other users and grant them permission to access and work in connected services. To access the list of user accounts in YouTrack, select Users from the Access Management section of the Administration menu.

Users list

The topics in this section of the documentation explain how to perform a variety of actions related to user accounts in YouTrack.

Searching for Users

The Users page features a search box that allows you to filter the list. YouTrack supports the attributes listed here in search queries that are applied as a filter on the Users page. You can also use these search attributes to filter users in the Members tab on group profile pages.

Attribute

Value

Description

login

<username>

Returns a user with the specified username. For example, login: l.butler.

loginStartsWith

<string>

Returns users whose usernames start with the specified string of characters.

name

<user full name>

Returns a user with the specified full name. For example, name: {Lisa Butler}.

nameStartsWith

string

Returns users whose full names start with the specified string of characters.

email

email

Returns users with the specified email.

vcsUserName

<VCS username>

Returns users with the specified VCS username.

ownRole

<role>

Returns users who have been directly granted the specified role in any project.

in

<group>

Returns users who are members of the specified group or any of its subgroups.

group

group

Returns users who are members of the specified group.

authMethod

authModule

authModule

Returns users with whose user accounts are associated with the specified authentication module.

authName

userName

Returns users with the specified full name in any authentication module that has been enabled in YouTrack.

authLogin

userLogin

Returns users with the specified username registered in any authentication module that has been enabled in YouTrack.

googleID

value

Returns user accounts with the specified identifier in Google.

openID

value

Returns user accounts with the specified identifier in a connected OpenID service.

sshPublicKey

value

Returns a user account that has an SSH public key with the specified fingerprint.

after

date

Returns user accounts created after the specified date. For example, to find all accounts that were created after 12:00 of May 26, 2017, enter after: {2017-05-26T12:00}

before

date

Returns user accounts created before the specified date. For example, to find all accounts that were created before May 26, 2017, enter: before: {2017-05-26}

has

ownRole

Returns users who have been directly granted roles in any project.

group

Returns users who are members of any group apart from the All Users group.

2FA

Returns users who have enabled two-factor authentication for their user accounts.

authMethod

Returns users who have at least one set of credentials stored in the system.

email

Returns user accounts that have at least one email address stored in their profile.

originService

Returns user accounts with a set of credentials that were imported from a service.

login

Returns user accounts that have credentials that were not imported from a service or another authentication provider.

sshPublicKey

Returns users who have an SSH public key.

refresh token

Returns users who have been issued refresh tokens.

permanent token

Returns user accounts that have generated a permanent token.

is

guest

Returns the account for the guest user.

banned

Returns users whose accounts are currently banned from accessing the system.

supporting2FA

Returns users who have at least one set of credentials that is capable of supporting two-factor authentication. This includes credentials that are provided by the Hub, Atlassian Jira, and LDAP-based authentication modules.

Supported sub-queries

Sub-query

Description

access(project: project, with: role)

Returns users who have been granted the specified role in the specified project.

access(project: project, with: permission)

Returns users who have been granted the specified permission in the specified project.

access(project: project)

Returns users who have been granted any role in the specified project.

access(with: role)

Returns users who have been granted the specified role in any project.

access(with: permission)

Returns users who have been granted the specified permission in any project.

lastAccess(after: instant)

Returns users who accessed YouTrack after the specified date.

lastAccess(before: instant)

Returns users who accessed YouTrack before the specified date.

lastAccess(after: instant, before: instant)

Returns users who accessed YouTrack between the specified dates.

Last modified: 01 April 2025