Attribute-based Search

Syntax for Attribute-based Search

Each issue has a number of attributes, such as project, state, issue ID, and assignee. In turn, each attribute has a value. When you search, you specify the attribute that you want to check and the value that is currently assigned to the issues that you want to find.

Use the following guidelines to compose an attribute-based search query:

The key to mastering attribute-based search is knowing which attributes contain the values that are relevant to the issues you want to find. For a complete list of issue attributes that are supported in search queries, see Search Query Reference.

Search Suggestions for User Accounts

Search attributes that reference users display user logins in the auto-completion list. The following example shows how user data is displayed in auto-completion dialogs.

These suggestions are only offered when you are granted the Read User Basic permission in at least one project. If you have not been granted this permission, the only user suggested is your own account.

note

Dealing with Broken References to Users in Saved Searches and Settings that Store Query Strings

In YouTrack versions earlier than 2019.2.60865, the visibility of user logins in auto-completion dialogs could be restricted using an experimental feature called Strict Suggestions. The functionality that was supported by this feature was made available by default starting from YouTrack 2019.2.60865.

When upgraded to the latest version of YouTrack, many users who were previously able to see suggestions for user accounts in search queries can no longer do so. This is because the permission requirement for viewing user data was not enforced if the Strict Suggestions feature was disabled. Following this update, the Read User Basic permission is required in all cases.

If you or other users encounter problems with saved searches, agile boards, reports, or dashboard widgets that stopped working when your installation was upgraded to the latest version, check the permissions that are assigned to affected users. Granting the Read User Basic permission in at least one project should solve the problem.

Wildcards in Attribute-based Search

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, project names, and tags.

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

Single Value Search

You can search for specific values without referencing the attribute that stores the value. YouTrack returns issues that contain the specified value in any issue attribute that does not store text.

To search for single values, substitute the attribute with a number sign and enter the value directly. Use the minus sign to exclude a value.

To find issues that are in progress that are not support requests, enter:

#{In Progress} -{Support Request}

Use keywords to reference specific issue properties. For a complete list of keywords, see Keywords.

To find a list of issues that you reported, are assigned, or added a comment to that are unresolved, enter:

#me -Resolved

Searching for a Range of Values

You can search for issues that contain a value inside a range of values for a specified attribute.

To search for a range:

1. Enter the name of the attribute, followed by a colon (:).

2. Enter the value that defines the upper or lower bound of the range, followed by two periods (..).

3. Enter the value that closes the range. To search for an open range, use the * character as a wildcard.

4. Execute the search query.

YouTrack applies the following logic to search queries that specify a range of values:

• The search results are always inclusive. This means that the query returns issues that contain the values that define the upper and lower bounds and every value in between. To exclude specific values, use the format -<value>.

• For attributes that store simple data types, YouTrack uses a basic mathematical comparison to exclude values that are less than the lower bound and greater than the upper bound. This logic applies to attributes that store a date, date and time, period, integer, and float type. Range search is not supported for attributes that store data as a string type.

• For attributes that store enumerated types, each value in the set is assigned an index number. Values with index numbers less than the lower bound and greater than the upper bound are excluded from the search results.

  These index numbers are assigned to each value based on the sort order that is applied to the set of values. Values can be sorted manually, by name, version, build, or by an additional property like release date or assemble date. This sort order can vary on a per-project basis. To get predictable results when you use a range of values to find issues in multiple projects, each project should use the same sort order for values in the specified field. For more information, see Sort Values in a Set.

  This logic applies to attributes that store enum, ownedField, state, version, and build types. Range search is not supported for projects or attributes that store an enumerated type as a user or group.

The following examples show how to search for ranges of values in attributes that store different types of data. These examples show different formulations for queries that use open and closed ranges.

Searching in Attributes that Store Text

For attributes like the issue summary, description, or comments, the values are stored as text. When you specify one of these attributes in your search query, YouTrack understands that you want to check the specified attribute for one or more words. Instead of attempting to match the value of the attribute exactly, YouTrack searches inside the attribute for matches to the specified text.

The syntax for text search is slightly different from the standard used for an attribute-based search. Instead of setting multiple words in braces, you can enter as many words as you want, in any order. For example, project: IDEADEV commenter: John Davis description: customer support returns all issues in the IDEADEV project that include comments from John Davis and contain forms of the words "customer" and "support" in the description.

You can also search for multiple words as a phrase by setting the words in quotation marks. that contain one or more words in the summary, description, or comments. For example, project: IDEADEV commenter: John Davis description: "customer support" returns all issues in the IDEADEV project that include comments from John Davis and contain forms of the words "customer" and "support" in the description as a phrase. For a complete description, see Text Search.

Query Completion

The Search box supports query completion. Query completion suggests possible attributes and values that are based on your current input. When you start typing an empty search query, YouTrack suggests attributes and values for keywords that match the current input. You can select an item from the list using your mouse or keyboard.

• If you select an attribute, the query completion suggests possible values for the selected attribute.

• If you select a single value, the value is added to the query.

To display query completion at the current position in the search box, press Ctrl + Spacebar or Alt + Down Arrow.

Visual Indicators

When you enter a query in the search box, YouTrack applies visual indicators to the query. This formatting tells you that your query has been parsed as a structured search.

• Attributes are underlined in gray.

• Values are underlined in black.

• Words that are parsed as text search are not formatted.

• Invalid parameters are underlined with a dotted red line.

note

Experimental Feature

An updated version of the Issues list is currently available on an experimental basis. The information provided here applies to the classic version of the page. To learn how highlighting is applied to search queries in the experimental version, see Query Syntax Highlights.