YouTrack Standalone 2017.1 Help

Search

To find issues that are assigned to, commented by, reported by, or starred for you, select a predefined search option from the Issues drop-down menu:

/help/img/youtrack/2017.1/issues_search_menu.png

For all other searches, whether simple or very complex, enter a query. You can search for issues across the entire YouTrack server or in selected projects using a wide range of search criteria.

To get started, move the focus to the search box. If the focus is anywhere outside of the search box, just press Esc to move it back. Then, enter a search query.

/help/img/youtrack/2017.1/search_box_w_notes.png

Search Queries

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 for issues, you specify the attribute and the value that you want to find. For example, project: IDEADEV returns all issues in the IDEADEV project. To limit the scope of your search to a single project, select a project from the Search Context drop-down list to the left of the search box. For more information, see Search Context.

You can combine multiple attribute-value pairs to refine your search. You can enter these search parameters in any order. For example, project: IDEADEV commenter: John Davis returns only issues in the IDEADEV that include comments from John Davis. For unambiguous values, you can replace the attribute with the number sign. For example, the query state: open becomes #open. Both queries return issues that match the specified state.

You can also search for issues that contain one or more words in the summary, description, or comments. For example, project: IDEADEV commenter: John Davis "customer support" returns all issues in the IDEADEV project that include comments from John Davis and contain the words "customer" and "support" in the specified order. For more information, see Text Search.

For complex searches, use query operators and symbols, such as OR, AND, -, and ... These operators exclude or combine multiple search attributes, change the processing order, define a range of values, and more. For details, see Operators and Symbols.

To summarize, a search query contains one or more of the following:

  • An attribute-value pair. For example, priority: critical
  • A keyword that represents an issue attribute or value in a custom field. For example, #my, #unassigned, #unresolved, or #{has attachment}.
  • A string of text to find in the issue summary, description, or comments.

Query Completion

The Search box supports query completion. Query completion suggests possible keywords and values that are based on your current input.
To display query completion at the current position in the search box, press Ctrl + Spacebar or Alt + Down Arrow.

/help/img/youtrack/2017.1/query_completion.png

Visual Indicators

When you enter a query in the search box, YouTrack formats the search query:

  • Keywords and attributes are underlined in gray.
  • Values are underlined in black.
  • Invalid parameters are underlined with a dotted red line.

Saved Search

You can save a search query for future use. To save a search, click the Save search link under the search box.

To execute a saved search:

  1. Enter saved search: in the search box.
  2. Enter the name of the saved search.
  3. Press Enter.

For more information, see Saved Search.

Filters

After executing a search query, you can apply a filter to refine the search results. For more information, see Filters.

Sample Search Queries

The following table provides a few examples of common search requests. For a complete list of keywords and search attributes with more sample queries, see Search Query Reference.

Search QueryDescription
for: me
assigned to: me
Returns all issues that are assigned to me (the current user).
for: John Davis type: bug,taskReturns issues with the type Bug and Task that are assigned to John Davis.
#my #unresolvedReturns all issues either assigned to or reported by the current user that have any state that is not considered Resolved.
state: submitted #unassigned type: feature
#feature #unassigned #submitted
Returns all feature requests that had been submitted but not yet assigned to a developer.
priority: critical updated: {this week}Returns all critical issues that were updated this week.
context action state: openReturns all open issues that contain the words "context" and "action".
#unresolved -minor sort by: priority ascReturns all unresolved issues except for issues with minor priority and sorts the list of issues by priority in ascending order.
"customer support" reported by: John DavisReturns all issues that were reported by John Davis and contain word forms for "customer" and "support" in the specified order.
Last modified: 18 April 2017