YouTrack Keyword Reference

Skip to end of metadata
Go to start of metadata
Search

Searching YouTrack 1.x Documentation

Table of Contents

The following table lists keywords that are provided in YouTrack query language to denote attributes before specifying their values, among other purposes. For every keyword, all supported attribute values, description, and sample queries are provided.
Note that you can use both singular and plural forms for predefined attribute values. For example, #my #show-stopper and #my #show-stoppers yield identical results.
See Contextual Help: Search for Issues for details on YouTrack syntax rules.

Keywords in YouTrack Daring

Please note that YouTrack is being actively developed and is not yet released. The Early Access Program for YouTrack Daring is open, and you can find the latest EAP build here.

In YouTrack Daring the following keywords were introduced or enhanced:

Keyword Values Keyword meaning Sample query Sample query meaning
me none Issues assigned to, reported by, or commented by the current user
is equal to
"Find all issues that were assigned to, or reported by, or commented by the current user"
commented Today
Yesterday
{This week}
{This month}
{Last week}
{Last month}
Older
username 		Search for issues that were commented during specified period or by specified user.
"Find all issues in project YouTrack assigned to the current user, which were commented during the last week."
commented by or
commenter 		username Search for issues that were commented by specified user.
"Find all issues which were created today, assigned to the current user, and commented by John."
viewed or
read 		none Issues that have been "touched" by the current user — expanded in the issue list, or opened in the full screen mode — at least once.
"Find all tasks created yesterday and assigned to me, which I already viewed"
{not viewed} or
unread 		none Issues that have never been expanded in the issue list or opened in the full screen mode by the current user.
"Find all usability problems reported or updated this week, assigned to me, but which I have not yet viewed."

Keywords Used in YouTrack 1.x

Keyword Possible values Keyword meaning Sample query Sample query meaning
my none Issues assigned to or reported by current user
or
"Find all issues assigned to or reported by current user that have any state except resolved"
me none Issues assigned to or reported by the current user.
is equal to
"Find all issues that were assigned to, or reported by, or commented by the current user"
for user login User that an issue was assigned to
"Find all issues with priority show-stopper that were assigned to user John"
assigned to Same as "for"
unassigned none Issues that were not assigned to a specific user
"Find unassigned issues (with empty assignee) in project ReSharper"
by user login User that created an issue
"Find all bugs reported by user yarko except for those with minor or normal priority"
created by Same as "by"  
or
"Find all issues reported by current user today"
updater user login
me 		User that updated an issue
or
"Find all major issues updated yesterday by the current user"
issue id issue identifier Automatically generated issue identifier, typically consisting of project short name and number code
"Find two specific issues: XX-2 and MPS-3143"
state -new-
submitted
open
in progress
reopened
resolved
unresolved
fixed
won't fix
can't reproduce
duplicate
incomplete
obsolete
to be discussed		 The current state of an issue
Note that resolved and unresolved are special states that can't be assigned to an issue but instead are used to search for issues that can have any state from a specified set.
resolved covers the following states: fixed, won't fix, duplicate, incomplete, obsolete, can't reproduce.
unresolved covers the following states: submitted, open, in progress, reopened, to be discussed.
or
"Find all critical bugs assigned to user john that were closed with state won't fix"
created older
today
yesterday
last week
this week
last month
this month 		Time span during which an issue was created
or
"Find all issues that were created today and assigned to current user"
updated older
today
yesterday
last week
this week
last month
this month 		Time span during which an issue was last updated
"Find all resolved issues in project mps that were updated during this month"
type bug
task
feature
cosmetics
exception
meta issue
usability problem
performance problem 		One of several predefined types of an issue
"Find all issues of type exception assigned to current user"
priority minor
normal
major
critical
show-stopper 		One of several predefined priority levels of an issue
"Find all unresolved issues with priority show-stopper assigned to me"
project administrator-defined Name of a project configured in your YouTrack installation that an issue belongs to
or
"Find all issues within project ReSharper assigned to current user"
subsystem administrator-defined Name of a subsystem within a project that an issue belongs to
"Find all issues that belong to subsystem smart ui"
in project or subsystem Specifies project or subsystem that an issue belongs to
"Find all issues reported by user kostik in project MPS"
affects administrator-defined Code of version where an issue was observed
or
or
"Find all issues assigned to user John that were observed in version EAP3"
that affect Same as "affects"
affecting Same as "affects"
fixed in administrator-defined Code of version where an issue was fixed
"Find all issues assigned to user John that were fixed for version EAP3"
tag user-defined Tag assigned to an issue
or
"Find all issues with priority minor that were associated with tag myparser"
tagged as Same as "tag"
saved search user-defined Name of a previously saved search query
"Re-execute search query that was saved as resharper this week"
sort by name of any other category Sort criteria
"Find all issues with state fixed that were either assigned to or reported by current user, and sort them by date of last update in descending order, displaying the most recently updated issue first"
asc, desc none Sort order for sort criteria specified by the "sort by" keyword
"Find all unresolved issues and sort the list of issues by priority in ascending order"
has attachment none Filter for issues that contain attachments
"Find all unresolved issues with attached files"
Note that this shortcut keyword is used according to rules for attribute values - that is, it requires both a hash mark and curly braces.

Labels:

keyword keyword Delete
query query Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.