Search Query Reference - Help | YouTrack Standalone

Text Search

YouTrack lets you search for issues that contain words or combinations of words. You can either search for words in any issue attribute, or limit the search query to find words in a specific attribute.

If text indexing is enabled for the language that you use in YouTrack, YouTrack returns issues that contain all forms of the words that you enter in a search query. Text in English is indexed by default. For more information, see Text Search.

Follow these guidelines to search for text in a query:

Enter a single word to find issues that contain this word. If the language has been indexed, YouTrack also returns issues that contain morphological variants of the specified word.
Set multiple words in braces to find issues that contain any of these words in any order. If the language has been indexed, YouTrack also returns issues that contain morphological variants of the specified words.
Set text in quotes to find issues that contain words in a specific order. If the language has been indexed, YouTrack returns issues that contain variants of every word in the specified order.
Use wildcards to expand the text search to include characters that do not exactly match your search criteria.
- * — matches zero or more characters in a string. You can also use this wildcard in other search attributes. For more information, see Wildcards in Search Attributes
- ? — matches any single character in a string. You can only use this wildcard to search the text attributes that appear in the following table. You cannot use this wildcard to search for values in custom fields that store values as a string type.

If you do not specify which attribute to search in, YouTrack returns all issues that contain matching words and their morphological variants in any text attribute. You can limit the search to find words in one of the following attributes.

Attribute	Values	Description	Examples
summary	word {multiple words} "sequence of words"	Returns issues that contain word forms that match the specified word or words in the issue summary.	To find issues with either 'scrum' or 'board' in the summary, enter: `summary: {scrum board}` To find issues in the 'TS' project that are assigned to the user 'john.johnson' with the words 'Agile management' in the summary (appearing in this order), enter: `in: TS assigned to: john.johnson summary: "Agile management"`
description	word {multiple words} "sequence of words"	Returns issues that contain word forms that match the specified word or words in the issue description.	To find unresolved issues in the 'GR' project with the string 'groovy.lang.resolve.CollectClassMembersUtil' in the description, enter: `in: GR #unresolved description: "groovy.lang.resolve.CollectClassMembersUtil"`
comments	word {multiple words} "sequence of words"	Returns issues that contain word forms that match the specified word or words in a comment.	To find issues in the 'JT' project with the type 'Feature' in the 'Agile management' subsystem that have comments that contain the word 'burndown', enter: `in: JT #Feature Subsystem: {Agile management} comments: burndown`
attachments	filename	Returns issues that include attachments with the specified filename.	To find unresolved issues that are assigned to me and have an attachment with a filename that starts with 'sketch', enter: `#unresolved for: me attachments: sketch*`
code	word {multiple words} "sequence of words"	Returns issues that contain word forms that match the specified word or words inside {code} markup tags. The {code} markup can be used in the issue description and comments. When you search by `code`, the query returns issues that contain variants of the specified words in the description or a comment.	To find unresolved issues in the TS project with the words 'foo' and 'bar' inside {code} tags in a description or comment, enter: `in: TS #unresolved code: {foo bar}`

Operators

Use the following operators to create logical combinations of attributes in a search query.

Operator	Description	Examples
-	Exclude a subset from a set of search query results. When you use this operator with an attribute value, do not use the number sign.	To find all unresolved issues except for issues with minor priority and sort the list of results by priority in ascending order, enter: `#unresolved -minor sort by: priority asc`
AND	Combine multiple search attribute subsets to expand the search request. Use this operator for issue fields with `enum[*]` types and tags. The AND-expression is always processed as group and has a higher priority than OR-expressions in the query.	To find all issues in the 'TEST project' that have both the 'Next build' and 'to be tested' tags, enter: `in: TEST and (tag:{Next build} and tag:{to be tested})` To find all issues that are have the priority 'Critical' in project 'A' or have the priority 'Major' and are assigned to the current user in project 'B', enter: `in: A #Critical or in: B #Major and for: me`
OR	Combine multiple search attribute subsets to restrict the search request.	To find all issues in the 'TEST' project that are assigned to the current user or have the tag 'to be tested' in any project, enter: `in: TEST for: me or tag: {to be tested}`
( )	Combine various search attributes to change the order in which attributes and operators are processed. The part of a search query inside the parentheses has priority and is always processed as a single unit. A parentheses-expression can be used only as argument for OR- or AND-expressions. For example, the search query `in:A #Critical (in:B and for:me)` cannot be processed.	To find all issues that are assigned to the current user and are either 'Critical' in project 'A' or 'Major' in project 'B', enter: `(in: A #Critical or in: B #Major) and for: me`

Symbols

The following symbols can be used to extend or refine a search query.

Symbol	Description	Examples
,	List multiple values for a single attribute. Can be used in combination with a range.	To find all issues assigned to, reported or commented by the current user, which were created today or yesterday, enter: `#my created: Today, Yesterday`
..	Defines a range of values.	To find all issues fixed in version 1.2.1 and in all versions from 1.3 to 1.5, enter: `fixed in: 1.2.1, 1.3 .. 1.5` To find all issues created since March 10 until March 13, 2011, enter: `created: 2011-03-10 .. 2011-03-13`
#	Indicates that the attribute is a keyword or a single value.	To find all unresolved issues in the 'MRK' project that were reported by, assigned to, or commented by the current user, enter: `#my #unresolved in: MRK`
{ }	Encloses attribute values that contain spaces.	To find all issues with the 'Fixed' state that have the tag 'to be tested', enter: `#Fixed tag: {to be tested}`

Keywords

The attributes in the following table are keywords. When you use a keyword in a search query, you do not specify a value for the attribute. A keyword is preceded by the number sign (#) or the minus operator. In the YouTrack Search Query Grammar, these keywords correspond to a <SingleValue>.

Keyword	Description	Examples
me my	Returns issues that are assigned to, reported by, or commented by the current user.	To find all issues assigned to or reported by current user that have any state except 'Resolved', enter: `#issues assigned to: me or reported by: me -Resolved` returns the same result as `#me -Resolved` and `#my -Resolved`
user	Returns issues that are assigned to, reported by, or commented by the specified user.	To find all issues that were assigned to, or reported by, or commented by the user with the login 'john' and were updated yesterday, enter: `#john updated: Yesterday`
issue ID	Returns an issue with the specified ID. You do not need to use the number sign to search by issue ID. When you search for an issue by ID, the result is displayed in full page view.	To find an issue with the ID 'JT-4232', enter: `JT-4232`
unassigned	Returns issues that are not assigned to a specific user.	To find unassigned issues in the 'ReSharper' project, enter: `project: ReSharper #unassigned`
{has attachment}	Returns issues that include attachments. This keyword follows the syntax for attribute values and requires both the number sign and braces. This keyword was deprecated in YouTrack 3.1 in favor of the `has: attachments` syntax.	To find all unresolved issues with attachments, enter: `#unresolved #{has attachment}`
resolved	Returns issues that are assigned a State that is considered to be resolved. For example, Fixed, Duplicate, or Obsolete.	To find all resolved issues that were updated today, enter: `#resolved updated: Today`
unresolved	Returns issues that are assigned a State that is considered to be unresolved. For example, Submitted, Open, or In Progress.	To find all unresolved issues that are assigned to the user 'john.doe' in the 'Test' project, enter: `#unresolved project: Test for: john.doe`

Boolean Search

The has keyword functions as a Boolean search term. When used in a search query, it returns all issues that contain a value for the specified attribute. Use the minus operator (-) before the specified attribute to find issues that have empty values.

For example, to find all issues in the 'TST' project that are assigned to the current user, have a duplicates link, have attachments, but do not have any comments, enter:
in: TST for: me has: duplicates , attachments , -comments

You can use the has keyword in combination with the following attributes:

Attribute	Description
attachments	Returns issues that have attachments.
{Board <board name>}	Returns issues that are assigned to the specified agile board.
comments	Returns issues that have comments.
description	Returns issues that do not have an empty description.
<field name>	Returns issues that contain any value in the specified custom field. Enclose field names that contain spaces in brackets.
<link name>	Returns issues that have links that match the specified outward name or inward name. Enclose link names that contain spaces in brackets.
links	Returns issues that have any issue link type.
star	Returns issues that have the star tag for the current user.
votes	Returns issues that have one or more votes.
work	Returns issues that have one or more work items.

Search Attributes

The following table includes all supported search attributes and their corresponding values. These attributes represent an <Attribute> in the Search Query Grammar. Their values correspond to the <Value> or <ValueRange> parameter.

Attribute	Values	Description	Examples
commented	<date> <custom period> relative date parameter user group	Returns issues to which comments were added on the specified date, within the specified period, by the specified user, or by a member of the specified group.	To find all issues in the 'YouTrack' project that are assigned to the current user and were commented during the last week, enter: `#YouTrack for: me commented: {Last Week}`
commented by commenter	user group	Returns issues that were commented by the specified user or by a member of the specified group	To find all issues which were created today, assigned to the current user, and commented by the user with the login 'John', enter: `created: today for: me commented by: John`
<issue link type>	issue ID	Returns issues that have links of the specified type to the specified issue. You can enter the outward name or inward name of any issue link type used in your YouTrack instance.	To find all tasks that are assigned to the current user and are related to the issue with the ID 'JT-5072' or duplicate the issue with the ID 'JT-4367', enter: `for: me #task relates to: JT-5072 or duplicates: JT-4367`
links	issue ID	Returns all issues that contains links to the specified issue.	To find all issues in the 'TEST' project that are linked to the issue 'ABC-4532', enter: `in: TEST links: ABC-4532`
for assigned to	user me group	Returns all issues that are assigned to the specified user, the current user, or a member of the specified group.	To find all issues with priority 'Show-stopper' that are assigned to the user with the login 'John', enter: `priority: show-stopper for: John`
by created by reported by	user me group	Returns issues that were created by the specified user, the current user, or a member of the specified user group.	To find all bugs reported by the user with the login 'yarko' except for those with minor or normal priority, enter: `#bug by: yarko -minor -normal` or `#bug created by: yarko -minor -normal`
updater updated by	user me group	Returns issues that were updated by the specified user, the current user, or a member of the specified user group.	To find all major issues that were updated yesterday by the current user, enter: `updater: me updated: yesterday priority: major` or `updater: me #yesterday #major`
issue id	issue ID	Returns issues that match the specified issue ID. The issue ID is an auto-generated identifier that typically consists of the project short name followed by a dash and a number.	To find two specific issues: 'XX-2' and 'MPS-3143', enter: `issue id: XX-2, MPS-3143`
state	submitted open in progress reopened resolved unresolved fixed won't fix can't reproduce duplicate incomplete obsolete to be discussed	Returns issues that match the specified state. The Resolved and Unresolved states cannot be assigned to an issue directly, as they are properties of specific values that are stored in the State field. By default, Fixed, Won't fix, Duplicate, Incomplete, Obsolete, and Can't reproduce states are set as Resolved. The Submitted, Open, In Progress, Reopened, and To be discussed states are set as Unresolved.	To find all critical bugs that are assigned to the user with the login 'john' that were closed with the state 'Won't fix', enter: `#{won't fix} #critical #bug for: john` or `state: {won't fix} priority: critical #bug for: john`
created	<date> <custom period> relative date parameter	Returns issues that were created on a specific date or within a specified time frame.	To find all issues that were created today and are assigned to the current user, enter: `#my #issues created: today` or `#my created: today`
updated	<date> <custom period> relative date parameter	Returns issues that were updated on a specific date or within a specified time frame.	To find all issues that are resolved in the 'MPS' project that were updated this month, enter: `#MPS updated: {this month} #resolved`
resolved date	<date> <custom period> relative date parameter	Returns issues that were resolved on a specific date or within a specified time frame.	To find all issues that are resolved in the 'MPS' project this month, enter: `#MPS resolved date: {this month}`
type	bug task feature cosmetics exception meta issue usability problem performance problem	Returns issues that match the specified issue type.	To find all issues that are assigned the 'Exception' type and are assigned to the current user, enter: `#exception assigned to: me`
priority	minor normal major critical show-stopper	Returns issues that match the specified priority level.	To find all unresolved issues with the priority 'Show-stopper' that are assigned to the current user, enter: `#my #unresolved #show-stoppers` or `#my state: unresolved priority: show-stopper`
project	<project name>	Returns issues that were created in the specified project.	To find all issues that were created in the 'ReSharper' project that are assigned to current user, enter: `#my #ReSharper #issues` or `#my #ReSharper`
subsystem	<field value>	Returns issues that are assigned to a specific subsystem within a project.	To find all issues that belong to the 'Smart UI' subsystem, enter: `subsystem: {smart ui}`
<custom field>	<field value>	Returns issues that contain a matching value in the specified custom field.	To find all issues that are assigned to the current user with the a value in the 'Deadline' field that matches today's date, enter: `for: me Deadline: Today`
in	project or subsystem	Returns issues that are assigned to the specified project or subsystem.	To find all issues that were reported by the user 'kostik' in the 'MPS' project, enter: `#issues created by: kostik in: MPS`
that affect	<version field value>	Returns issues that were detected in the specified version or build.	To find all issues that are assigned to the user 'John' that were observed in version 'EAP3' of the product, enter: `affects: EAP3 assigned to: John` or `#issues affecting: EAP3 assigned to: John` or `#issues that affect: EAP3 assigned to: John`
fix for	<version field value>	Returns issues that are to be fixed in a specified version of the product.	To find all issues in the 'TEST' project that are assigned to the user 'John' and should be fixed for version '1.0.2' of the product, enter: `in: Test for: John fix for: 1.0.2`
fixed in	<version field value>	Returns issues that were fixed in a specified version of the product.	To find all issues that are assigned to the user 'John' that were fixed in version 'EAP3' of the product, enter: `for: John fixed in: EAP3`
tag tagged as	<tag>	Returns issues that match a specified tag.	To find all issues with the priority 'Minor' that were associated with the 'myparser' tag, enter: `#minor tag: myparser` or `#minor #issues tagged as: myparser`
saved search	<saved search>	Returns issues that match the search criteria of a saved search.	To find issues that match the search query that was saved as 'resharper this week', enter: `saved search: {resharper this week}`
Board <board name>	<sprint name>	Returns issues that are assigned to the specified sprint on the specified agile board. Enclose sprint names with more than one word in braces. You can also substitute the sprint name with `{current sprint}` to find issues that are assigned to the current sprint. To learn how YouTrack identifies the current sprint, see The Current Sprint.	To find all issues that are assigned to sprint 21 on the YouTrack scrum board, enter: `Board YouTrack scrum: {sprint 21}`

Wildcards in Search Attributes

You can use the * character as a wildcard in search attributes that reference values in many custom fields and sprints. This wildcard matches zero or more characters in the search request. You can only add a wildcard to the end of an attribute value.

You can use the * wildcard to find values in custom fields that store an enum, state, ownedField, version, or build. You can also use this wildcard for sprint names.
Wildcards are not supported for fields that store a user, date, period, float, or integer.
The ? wildcard is not supported in attribute-based search queries, even for custom fields that store a string type.

Search Attributes for Time Tracking

There is a dedicated set of search attributes that you can use to find issues that contain time tracking data. These attributes look for specific values that have been added as work items to an issue.

Attribute	Values	Description	Examples
work author	user me	Returns issues that have work items that were added by the specified user.	To find all issues in the 'TST' project that have work items that were added by the current user, enter: `in: TST work author: me`
work type	<work item type>	Returns issues that have work items that are assigned the specified work item type. The query `work type: {No type}` returns issues that have work items that are not assigned a work item type.	To find all issues in the 'TST' project that have work items that are assigned the `Development` work item type, enter: `in: TST work type: Development`
work date	<date> <custom period> relative date parameter	Returns issues that have work items that are recorded for the specified date or within the specified time frame.	To find all issues in the 'TST' project that have work items that were added last week, enter: `in: TST work date: {Last week}`

Date and Period Values

Several search attributes reference values that are stored as a date. You can search for dates as single values or use a range of values to define a period.

Specify dates in the format: YYYY-MM-DD or YYYY-MM or MM-DD. You also can specify a time in 24h format: HH:MM:SS or HH:MM. To specify both date and time, use the format: YYYY-MM-DD}}T{{HH:MM:SS. For example, the search query created: 2010-01-01T12:00 .. 2010-01-01T15:00 returns all issues that were created on 1 January 2010 between 12:00 and 15:00.

You can also use pre-defined relative parameters to search for date values. The values for these parameters are calculated relative to the current date according to the time zone of the current user. The actual value for each parameter is shown in the query assist panel.

The following relative date parameters are supported:

Parameter	Description
Today	The current calendar day.
Yesterday	The previous calendar day.
Sunday	The calendar Sunday for the current week.
Monday	The calendar Monday for the current week.
Tuesday	The calendar Tuesday for the current week.
Wednesday	The calendar Wednesday for the current week.
Thursday	The calendar Thursday for the current week.
Friday	The calendar Friday for the current week.
Saturday	The calendar Saturday for the current week.
{This week}	The period from 00:00 Monday to 23:59 Sunday for the current week.
{Last week}	The period from 00:00 Monday to 23:59 for the previous week.
{Two weeks ago}	The period from 00:00 Monday to 23:59 for the calendar week two weeks prior to the current date.
{Three weeks ago}	The period from 00:00 Monday to 23:59 for the calendar week three weeks prior to the current date.
{This month}	The period from the first day to the last day of the current calendar month.
{Last month}	The period from the first day to the last day of the previous calendar month.
Older	The period from 1 January 1970 to the last day of the month two months prior to the current date.

Sort Attributes

You can specify the sort order for the list of issues that are returned by the search query.

Attribute	Value	Sort Criteria	Example
sort by order by	attribute name	asc desc	To find all issues with the 'Fixed' state that were either assigned to or reported by the current user, and sort them by the date of the last update in descending order, displaying the most recently updated issue first, enter: `#my #fixed sort by: updated desc`

You can sort issues by any of the attributes on the following list. In the Search Query Grammar, these attributes represent the <SortAttribute> value.

star
updated

updater
{resolved date}

project
reporter

{issue id}
votes

summary
<custom field>