Search Query Reference

This page provides a list of attributes and keywords that are used in YouTrack query language. Each attribute is followed by a value in a search query. Keywords represent a single value.

For predefined attribute values, you can use both singular and plural forms. For example, #my #show-stopper and #my #show-stoppers yield identical results.
For more information on YouTrack search syntax, see Search Query Grammar.

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.

Operators

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

Symbols

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

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>.

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:

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.

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.

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:

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.