Search Query Reference
This page provides a list of attributes and keywords that are used in YouTrack query language. You'll also find a complete list of operators, symbols, and relative date parameters that are recognized in search queries.
Issue Attributes
Every issue has base attributes that are set automatically by YouTrack. These include the issue ID, the user who created or applied the last update to the issue, and so on.
These search attributes represent an <Attribute>
in the Search Query Grammar. Their values correspond to the <Value>
or <ValueRange>
parameter.
Attribute-based search uses the syntax attribute: value
.
You can specify multiple values for the target attribute, separated by commas.
Exclude specific values from the search results with the syntax
attribute: -value
.
In many cases, you can omit the attribute and reference values directly with the #
or -
symbols. For additional guidelines, see Attribute-based Search.
attachments
Returns issues that include attachments with the specified filename.
Values | Accepts text. If the filename contains spaces, set multiple words in quotes or braces. |
Example | To find unresolved issues that are assigned to me and have an attachment with a filename that starts with sketch, enter |
Board
Returns issues that are assigned to the specified sprint on the specified agile board. To find issues that are assigned to agile boards with sprints disabled, use has: <board name>
.
Values | Accepts the name of a sprint. Enclose sprint names with more than one word in braces. Substitute the sprint name with This attribute can also be referenced as a single value with the syntax |
Example | To find all issues that are assigned to sprint 21 on the YouTrack Scrum board, enter |
code
Returns issues that contain word forms that match the specified word or words that are formatted as code in the issue description or comments.
In YouTrack Wiki, this includes matches inside
{code}
markup tags.In Markdown, this includes matches that are formatted as inline code spans, indented and fenced code blocks, and stack traces.
Values | Accepts text. Values are parsed as described for Text Search. |
Example | To find unresolved issues in the TS project with the words hello and world that are formatted as code in a description or comment, enter |
commented
Returns issues to which comments were added on the specified date or within the specified period.
Values | Accepts a date, custom period, or relative date parameter. This attribute also accepts a user or group, but the unfiltered list of auto-completion options shows date-related values first. To see suggestions for users and groups, use the commenter attribute. |
Example | To find all issues in the YouTrack project that are assigned to the current user and were commented during the last week, enter |
commenter
Returns issues that were commented by the specified user or by a member of the specified group.
Values | Accepts a user or group. |
Aliases | commented by |
Example | To find all issues which were created today, assigned to the current user, and commented by the user with the login John, enter |
comments
Returns issues that contain word forms that match the specified word or words in a comment.
Values | Accepts text. Values are parsed as described for Text Search. |
Example | To find issues in the JT project with the type Feature in the Agile management subsystem that contain the word burndown in one or more comments, enter |
created
Returns issues that were created on a specific date or within a specified time frame.
Values | Accepts a date, custom period, or relative date parameter. This attribute also accepts a user or group, but the unfiltered list of auto-completion options shows date-related values first. To see suggestions for users and groups, use the reporter attribute. |
Example | To find all issues that were created today and are assigned to the current user, enter |
description
Returns issues that contain word forms that match the specified word or words in the issue description.
Values | Accepts text. Values are parsed as described for Text Search. |
Example | To find unresolved issues in the GR project with the string groovy.lang.resolve.CollectClassMembersUtil in the description, enter |
has
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 one or more 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 braces. |
<link type name> | Returns issues that have links that match the specified outward name or inward name. Enclose link names that contain spaces in braces. |
links | Returns issues that have any issue link type. |
star | Returns issues that have the star tag for the current user. |
vcs changes | Returns issues that contain vcs changes. |
votes | Returns issues that have one or more votes. |
work | Returns issues that have one or more work items. |
issue ID
Returns an issue that matches the specified issue ID. This attribute can also be referenced as a single value with the syntax #<issue ID>
or -<issue ID>
. When the search returns a single issue, the result is displayed in single issue view.
If you don't use the syntax for an attribute-based search (
issue ID: <value>
or#<value>
), the input is also parsed as a text search. In addition to any issue that matches the specified issue ID, the search results include any issue that contains the specified ID in any text attribute.If you set the issue ID in quotes, the input is only parsed as a text search. The search results only include issues that contain the specified ID in a text attribute.
Note that even when an issue ID is parsed as a text search, the results do not include issue links. To find issues based on issue links, use the links attribute or reference a specific link type.
Values | Accepts only an issue ID. |
Example | To find an issue with the ID JT-4232, enter
|
links
Returns all issues that contains links to the specified issue.
Values | Accepts only an issue ID. |
Example | To find all issues in the TEST project that are linked to the issue ABC-4532, enter |
looks like
Returns issues in which the issue summary or description contains words that are found in the issue summary or description in the specified issue. Issues that contain matching words in the issue summary are given higher weight when the search results are sorted by relevance.
Values | Accepts only an issue ID. |
Example | To find all issues in the TEST project that contain matching words that are used in the the issue summary and description for ABC-4532, enter |
mentions
Returns issues that contain @mention references for the specified user in the description or a comment. User mentions in supplemental text fields are not included in the search results.
Values | Accepts a user. |
Example | To find all issues that mention a user with the login valerie but do not contain mentions that reference your account, enter |
project
Returns issues that belong to the specified project. This attribute can also be referenced as a single value.
Values | Accepts a project name or project ID. |
Aliases | in |
Example | To find all issues that belong to the ReSharper project that are assigned to current user, enter |
reporter
Returns issues that were created by the specified user or a member of the specified group. Use me
to return issues that were created by the current user.
Values | Accepts a user or group. |
Aliases | by, created by, reported by |
Example | To find all bugs reported by the user with the login yarko except for those with minor or normal priority, enter |
resolved date
Returns issues that were resolved on a specific date or within a specified time frame.
Values | Accepts a date, custom period, or relative date parameter. |
Example | To find all issues that are resolved in the MPS project this month, enter |
saved search
Returns issues that match the search criteria of a saved search. This attribute can also be referenced as a single value with the syntax #<saved search name>
or -<saved search name>
.
Values | Accepts the name of a saved search. |
Example | To find issues that match a search query that was saved as resharper this week, enter |
summary
Returns issues that contain word forms that match the specified word or words in the issue summary.
Values | Accepts text. Values are parsed as described for Text Search. |
Example | To find issues with either scrum or board in the summary, enter |
tag
Returns issues that match a specified tag. This attribute can also be referenced as a single value with the syntax #<tag name>
or -<tag name>
Values | Accepts the name of a tag. |
Aliases | tagged as |
Example | To find all issues with the priority Minor that have the myparser tag, enter |
updated
Returns issues that were updated on a specific date or within a specified time frame.
Values | Accepts a date, custom period, or relative date parameter. This attribute also accepts a user or group, but the unfiltered list of auto-completion options shows date-related values first. To see suggestions for users and groups, use the updater attribute. |
Example | To find all issues that are resolved in the MPS project that were updated this month, enter |
updater
Returns issues that were last updated by the specified user or a member of the specified group. Use me
to return issues to which you applied the last update.
Values | Accepts a user or group. |
Aliases | updated by |
Example | To find all major issues that you were the last person to update yesterday, enter |
vcs changes
Returns issues that contain vcs changes that were applied in the commit object that is identified by the specified SHA-1 commit hash.
Values | Accepts a full SHA-1 commit hash. The short version of the commit hash is not recognized. |
Example | To find an issue that contains vcs changes for a specific commit, enter |
visible to
Returns issues that are visible to the specified user or a member of the specified group.
Values | Accepts a user or group. |
Example | To find all major issues for which the visibility is restricted to members of the YouTrack Team, enter |
voter
Returns issues that have votes from the specified user or a member of the specified group.
Values | Accepts a user or group. |
Aliases | voted by |
Example | To find all major issues that have votes from members of the YouTrack Team, enter |
Custom Fields
You can find issue that are assigned specific values in a custom field. As with other issue attributes, you use the syntax attribute: value
or attribute: -value
. In this case, the attribute is the name of the custom field. In most cases, you can reference values directly with the #
or -
symbols.
For custom fields that are assigned an empty value, you can reference this property as a value. For example, to search for issues that are not assigned to a specific user, enter Assignee: Unassigned
or #Unassigned
. If the field is not assigned an empty value, find issues that do not store a value in the field with the syntax <field name>: {No <field name>}
or has: -<field name>
.
This section lists the search attributes for default custom fields. Note that default fields and their values can be customized. The actual field names, values, and aliases may vary.
Affected versions
Returns issues that were detected in a specific version of the product.
Values | Accepts any of the values that are stored in the Affected versions field as well as the keywords |
Aliases | affects, affecting, that affect |
Example | To find all issues that are assigned to the user John that were detected in version EAP3 of the product, enter |
Assignee
Returns all issues that are assigned to the specified user or a member of the specified group.
Values | Accepts a user or group. |
Aliases | assigned to, for |
Example | To find all issues with priority Show-stopper that are assigned to the user with the login John, enter |
Fix versions
Returns issues that were fixed in a specific version of the product.
Values | Accepts any of the values that are stored in the Fix versions field as well as the keywords |
Aliases | fix for, fixed in, version |
Example | To find all issues that are assigned to the user John that were fixed in version EAP3 of the product, enter |
Fixed in build
Returns issues that were fixed in the specified build.
Values | Accepts any of the values that are stored in the Fixed in build field as well as the keyword |
Aliases | build, fix build, fix for, fixed in |
Example | To find all issues that are assigned to the user John that were fixed in build number 36724, enter |
Priority
Returns issues that match the specified priority level.
Values | Accepts any of the values that are stored in the Priority field as well as the keyword |
Example | To find all unresolved issues with the priority Show-stopper that are assigned to the current user, enter |
State
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.
Values | Accepts any of the values that are stored in the State field as well as the keywords |
Example | 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 |
Subsystem
Returns issues that are assigned to a specific subsystem within a project.
Values | Accepts any of the values that are stored in the Subsystem field as well as the keyword |
Aliases | in |
Example | To find all issues that belong to the Smart UI subsystem, enter |
Type
Returns issues that match the specified issue type.
Values | Accepts any of the values that are stored in the Type field as well as the keyword |
Example | To find all issues that are assigned the Exception type and are assigned to the current user, enter |
Issue Links
You can search for issues that are linked to a specific issue. If you simply want to find any issues that are linked to a target issue, use the links attribute. Otherwise, you can find issues that are linked to a target issue by a specific link type. When you specify these attributes, enter the outward name or inward name of any issue link type, then specify the target issue.
The following search attributes are associated with the default issue link types. Note that the default issue link types can be customized. The actual names may vary.
Depends on
Returns issues that have depends on links to a target issue.
Values | Accepts only an issue ID. |
Example | To find all tasks that are assigned to the current user depend on the issue JT-5072, enter |
Duplicates
Returns issues that have duplicates links to a target issue.
Values | Accepts only an issue ID. |
Example | To find issues that duplicate the issue JT-5072, enter |
Is duplicated by
Returns issues that have is duplicated by links to a target issue.
Values | Accepts only an issue ID. |
Example | To find issues that are duplicated by the issue JT-5072, enter |
Is required for
Returns issues that have is required for links to a target issue.
Values | Accepts only an issue ID. |
Example | To find all tasks that are assigned to the current user that are required for issue JT-5072, enter |
Parent for
Returns issues that have parent for links to a target issue.
Values | Accepts only an issue ID. |
Example | To find the parent task for JT-5072, enter |
Relates to
Returns issues that have relates to links to a target issue.
Values | Accepts only an issue ID. |
Example | To find all tasks that are assigned to the current user and are related to the issue with the ID JT-5072, enter |
Subtask of
Returns issues that have subtask of links to a target issue.
Values | Accepts only an issue ID. |
Example | To find all of the issues that are assigned to the current user and are linked as subtasks to JT-5072, enter |
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.
work author
Returns issues that have work items that were added by the specified user.
Values | Only accepts a user. |
Example | To find all issues in the 'TST' project that have work items that were added by the current user, enter: |
work 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.
Values | Accepts a predefined work item type. |
Example | To find all issues in the 'TST' project that have work items that are assigned the |
work date
Returns issues that have work items that are recorded for the specified date or within the specified time frame.
Values | Accepts a date, custom period, or relative date parameter. |
Example | To find all issues in the 'TST' project that have work items that were added last week, enter: |
Sort Attributes
You can specify the sort order for the list of issues that are returned by the search query.
You can sort issues by any of the attributes on the following list. In the Search Query Grammar, these attributes represent the <SortAttribute>
value.
sort by
Sorts issues that are returned by the query in the specified order.
Values | You can sort issues by values from the following attributes: star, updated, updater, {resolved date}, project, reporter, {issue id}, votes, summary, comments, and <custom field>. |
Sort Order | asc, desc |
Aliases | order by |
Example | 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 |
When you perform a text search, the results can be sorted by relevance. You cannot specify relevance as a sort attribute. For more information, see Sorting by Relevance.
Keywords
There are a number of values that can be substituted with a keyword. When you use a keyword in a search query, you do not specify an 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>
.
me
References the current user. This keyword can be used as a value for any attribute that accepts a user.
When used as a single value (#me
) the search returns issues that are assigned to, reported by, or commented by the current user.
For example, to find unresolved issues that are assigned to, reported by, or contain comments from the current user, enter #me -Resolved
.
The results also include issues that contain references to the current user in any custom field that stores values as users. For example, you have a custom field Reviewed by that stores a user
type. The search query #me -Resolved
also includes issues that reference the current user in this custom field.
my
An alias for me.
Resolved
This keyword references the Resolved issue property. This property is set based on the current value or combination of values for any custom field that stores a state
type. In the default State field, the Resolved property is enabled for the values Fixed, Won't fix, Duplicate, Incomplete, Obsolete, and Can't reproduce.
For projects that use multiple state-type fields, the Resolved property is only true when all of the state-type fields are assigned values that are considered to be resolved.
For example, to find all resolved issues that were updated today, enter #Resolved updated: Today
.
Unresolved
This keyword references the Unresolved issue property. This property is set based on the current value or combination of values for any custom field that stores a state
type. In the default State field, the Resolved property is disabled for the values Submitted, Open, In Progress, Reopened, and To be discussed.
For projects that use multiple state-type fields, the Unresolved property is true when any state-type fields is assigned a value that is not considered to be resolved.
For example, to find all unresolved issues that are assigned to the user john.doe in the Test project, enter #Unresolved project: Test for: john.doe
.
Released
This keyword references the Released property for values in a field that stores a version
type. It can only be used together with the attribute name or alias for a version field. This means that it cannot be referenced as a single value.
With fields that store multiple values, the search query returns issues for which at least one of the versions that is stored in the field is marked as released.
For example, to find all issues in the Test project that are fixed in a version that has not yet been released, enter in: Test fixed in: -Released
.
Archived
This keyword references the Archived property for values in a field that stores a version
type. It can only be used together with the attribute name or alias for a version field. This means that it cannot be referenced as a single value.
With fields that store multiple values, the search query only returns issues for which all of the versions that are stored in the field are marked as archived.
For example, to find all issues in the Test project that are fixed in a version that has been archived, enter in: Test fixed in: Archived
.
Operators
The search query grammar applies default semantics to search queries that do not contain explicit logical operators.
Searches that include multiple values for a single attribute are treated as disjunctive. This means that the values are handled as if joined by an
OR
operator. For example,State: {In Progress}, {To be discussed}
returns issues that are assigned either one or the other of these two states.For text search, searches that include multiple words are treated as conjunctive. This means that the words are handled as if joined by an
AND
operator. For example,State: Open context usage
returns issues that contain matching forms for both "context" and "usage".Searches that specify values for multiple attributes are treated as conjunctive. This means that the values are handled as if joined by an
AND
operator. For example,State: {In Progress} Priority: Critical
returns issues that are assigned the specified state and priority.
You can override the default semantics by applying explicit operators to the query.
Use the following operators to create logical combinations of attributes in a search query.
Operator | Description | Examples |
---|---|---|
AND | Combine multiple search attribute subsets to expand the search request. Use this operator for issue fields with 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 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 | 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 |
---|---|---|
- | Excludes a subset from a set of search query results. When you use this symbol with a single 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 |
# | Indicates that the input represents 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 |
, | Separates a list of 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 |
.. | Defines a range of values. Insert this symbol between the values that define the upper and lower ranges. The search results include the upper and lower bounds. | To find all issues fixed in version 1.2.1 and in all versions from 1.3 to 1.5, enter |
* | Wildcard character. Its behavior is context-dependent.
| To find all issues created on or before March 10, 2018, enter To find issues that are have tags that start with To find unresolved issues that contain image attachments in PNG format, enter |
? | Matches any single character in a string. You can only use this wildcard to search in attributes that store text. For more information, see Wildcards in Text Search. | To find issues that contain the words "prioritize" or "prioritise" in the issue description, enter |
{ } | Encloses attribute values that contain spaces. | To find all issues with the Fixed state that have the tag to be tested, enter |
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. |
Tomorrow | The next 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. |
{Last working day} | The most recent working day as defined by the Workdays that are configured in the settings on the Time Tracking page in YouTrack. |
{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 Sunday for the previous week. |
{Next week} | The period from 00:00 Monday to 23:59 Sunday for the next week. |
{Two weeks ago} | The period from 00:00 Monday to 23:59 Sunday for the calendar week two weeks prior to the current date. |
{Three weeks ago} | The period from 00:00 Monday to 23:59 Sunday 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. |
{Next month} | The period from the first day to the last day of the next calendar month. |
Older | The period from 1 January 1970 to the last day of the month two months prior to the current date. |