Contextual Help. Search for Issues

Skip to end of metadata
Go to start of metadata
Search

Searching YouTrack 2.x Documentation

Table of Contents

You search for issues by composing a search query. A search query must contain one or more of the following:

  • Keyword-value pairs (example: project: TeamCity) that identify attributes of issues that you search for. Issue attributes include issue ID, state, assignee, reporter, date of creation/update, type, priority, tags etc. For unambiguous values, you may omit keywords. For example, state: unresolved means exactly the same as #unresolved because #unresolved can only identify the state of an issue. On the other hand, #today is an ambiguous value because it is valid for two keywords: updated and created.
  • Shortcut keywords that represent one of the following:
    • A set of attribute values. Examples: #my (searches for issues assigned to or reported by the current user), #unresolved (searches for all submitted, open, reopened issues, issues in progress and due to be discussed).
    • A special state of an issue. Examples: #unassigned, #{has attachment}.
  • An arbitrary string for full-text search in issue summaries, descriptions etc.

To distinguish search by attributes from full-text search:

  • Attributes should be followed by a colon:
    state:
  • Attribute values that contain spaces should be surrounded by curly braces:
    in: {JetBrains Tracker}
  • If an attribute value is specified without attributes, it should be preceded by the hash mark:
    #unresolved

You can also use the "-" operator to subtract subsets from search query results. For example, #unresolved -critical displays all unresolved issues except for critical issues. Note that using the "-" operator before an attribute value doesn't require that you precede it with a hash mark.

YouTrack provides query completion in the search box to help you choose appropriate keywords and values. To display query completion at any caret position in the search box, press Ctrl+Space or Alt+Down.
In addition, after you have entered them in the search box, keywords are underlined with grey and values with black. If you've entered an incorrect query, YouTrack uses red dotted underline to highlight errors.

Most of the following commands are applicable in the Command window as well but if you use them in commands, the aforementioned rules regarding colons, curly braces and hash marks are not applied.

New and Updated Keywords in YouTrack 2.0

In YouTrack 2.0 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"
user name none Issues assigned to, reported by, or commented by the specified user
"Find all issues that were assigned to, or reported by, or commented by the user "john" and were updated Yesterday "
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."
relates to
duplicates
is duplicated by
depends on
is required for 		issue ID Search for issues that have links of specified type to certain issues
"Find all tasks assigned to the current user, which either relate to JT-5072 or duplicate JT-4367"

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:

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