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.
The topics in this section of the documentation explain how to perform a variety of actions related to user accounts in YouTrack.
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.
note
Custom AttributesThe search query language only supports queries that reference standard attributes. Searching for users based on values stored in custom attributes is not supported.
Attribute | Value | Description |
|---|---|---|
login | <username> | Returns a user with the specified username. For example, |
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, |
nameStartsWith | string | Returns users whose full names start with the specified string of characters. |
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 | 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 | |
before | Returns user accounts created before the specified date. For example, to find all accounts that were created before May 26, 2017, enter: | |
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. | |
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. |
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. |