The Issues List

Recent Issues and Articles

YouTrack gives you quick access to recently viewed items at the top of the page. These items can include issues, helpdesk tickets, and articles from the knowledge base.

The following options are available from this panel:

If you don't want to work with the list of recent issues and articles in YouTrack, you can disable this panel from the Workspace settings in your YouTrack profile. To learn more about workspace customization options in YouTrack, see Workspace Settings.

Search Queries and Filters

To get the most out of this view, it’s good to know how to filter this list and find the issues that are relevant to your work.

Filter Mode

YouTrack lets you selectively apply filters that restrict the list to show only issues that contain matching values for the selected attributes. Suggestions for possible attributes and values are suggested as you type.

When you apply a filter to the list, the following options are available:

• If you're working with an unfiltered list of issues, you have the option to save the current filters as a new saved search.

• If you're currently working with a list of issues that match a saved search, you are prompted to update the current query or save the filter as a new saved search.

To learn more about saved searches in YouTrack, see Saved Searches.

Query Mode

Query mode lets you filter the list of issues using a free-form search query. Enter the criteria that you want to use to define the search results and refine the list of issues.

This input field offers suggestions for possible matches to known issue attributes and field values. It also finds issues that contain keywords, phrases, and exact matches for arbitrary strings of characters.

To learn more about search queries in YouTrack, see Search.

When you update the query, the following options are available:

• If you're working with an unfiltered list of issues, you have the option to save the current search query as a new saved search.

• If you're currently working with a list of issues that match a saved search, you are prompted to update the current query or save the search criteria as a new saved search.

To learn more about saved searches in YouTrack, see Saved Searches.

Query Syntax Highlights

When you enter a query in the search box, YouTrack applies visual indicators to the query string. This formatting helps you understand how your search query is interpreted by the search engine.

• Issue attributes are shown as normal text without formatting.

• Attribute values are shown in blue text.

• Words that are parsed as text search are shown in gold.

• Invalid parameters are underlined in red.

To learn how YouTrack handles different types of search input, see Attribute-based Search and Text Search.

Highlights in Search Results

When you search for issues that contain specific strings of text, all the word forms that match the words that are specified in the query are highlighted in the list.

This makes it easier to find the exact issues that you were hoping to find with your search query.

Resolved Issue Filter

A dedicated control in the search box lets you apply a filter that hides resolved issues in one click.

The status of this filter is stored in the internal preferences for your user account. Once you activate the filter, resolved issues are excluded from subsequent search requests until you remove the filter.

If you enter a search query that explicitly references resolved states while this filter is active, no matches are shown. To show issues that match the query, you need to manually remove the resolved issue filter.

Issue Sidebar

The sidebar to the left of the Issues list grants you quick access to issues that match predefined search criteria and your personal collection of unreported issue drafts.

You can show or hide the sidebar by clicking the icon in the header. The following options are available:

• Keep sidebar open — the sidebar is always visible.

• Hide sidebar — the sidebar is only shown when you move the pointer over the icon in the header.

You can also one of these keyboard shortcuts:

• For Windows and Linux operating systems, press Ctrl + Shift + Backspace

• For macOS, press Control + Shift + Delete

Use this control to toggle the visibility of the sidebar based on the demands of your current activity or personal preference.

You also have the ability to increase the width of the sidebar by dragging the border to the right side of the page. This helps you to view the longer summaries in issue drafts and saved searches with longer names as well.

YouTrack remembers this width even when you navigate away from the page or close the application.

Drafts

The Drafts section of the sidebar lists any issue that you have started to report but never created.

The following options are available in this section of the sidebar:

Option	Description
Open	Select an item from the list to open the draft in the view for creating a new issue. This lets you pick up where you left off and continue to flesh out an issue until you're ready to report it. Once you create an issue from an open draft, it is automatically removed from the list of issue drafts in the sidebar. To learn more about reporting issues in YouTrack, see New Issue View.
Delete draft	Lets you delete the corresponding issue draft from YouTrack.
Delete all drafts	Completely empties the collection of unreported issue drafts for your account.
New issue	Opens an empty draft in a pop-up window. This lets you create new tasks without switching your work context from the list.

Projects

This section of the sidebar provides access to issues in your favorite projects.

To manage your list of favorite projects, click the Show more icon. This icon is only visible when you move the pointer over the Projects heading in the sidebar.

• To add an item to the sidebar, click Add to favorites.

• To remove an item, click Remove from favorites.

Tags

This section of the sidebar provides access to issues in your favorite projects.

To manage your list of favorite projects, click the Show more icon. This icon is only visible when you move the pointer over the Projects heading in the sidebar.

• To add an item to the sidebar, click Add to favorites.

• To remove an item, click Remove from favorites.

Saved Searches

This section of the sidebar shows the list of saved searches that you have marked as favorites in YouTrack. These saved searches give you immediate access to issues that match predefined search criteria.

To configure the list of saved searches, click the Show more icon. This icon is only visible when you move the pointer over the Saved Searches heading in the sidebar.

• To add an item to the sidebar, click Add to favorites.

• To remove an item, click Remove from favorites.

One of the options that's available from the list of saved searches in the sidebar is the ability to generate release notes. To learn more about this feature, see Generate Release Notes.

Issue Toolbar

The toolbar on the Issues list lets you access operations that can be applied to multiple issues in the list. This toolbar is shown whenever you select one or more issues.

The following controls are available:

Selecting Multiple Issues

One of the controls in the toolbar on the Issues list lets you select all the issues that are shown on the current page.

• Select the checkbox in the header row to select all the issues on the current page.

  

• When all the issues on the current page are selected, you see the option to select all the issues that match the current search query in the toolbar.

  

You can also select a range of issues by pressing the Shift key and clicking an issue. This inclusively selects all the issues from the issue that currently has focus to the issue that you click to select the range.

Exporting Issue Data

Another control in the toolbar lets you export data for the current list of issues. The following options are available:

These options are available when you click the Export data button in the issue toolbar.

Use these options to upload issues to another application or use third-party software to compile custom reports.

The maximum number of issues that you can export is determined by the Max Issues to Export setting on the Global Settings page. The default value is 500. If the number of issues that you want to export exceeds the global limit, ask an administrator to increase this value. For more information, see System.

When you select an export option, the list of issues is filtered to match the current search query and context. The export file contains the following details for each issue:

Issue Count

The number of issues that match the current search query or filter is shown at the top of the list.

When you display the list of issues using the Hierarchical (tree) view, this number shows how many issues that match the current search criteria. Non-matching parent issues are not included in this count. Parent issues that don't match the current search criteria are dimmed in the list.

The list shows a maximum of 100 issues per page. Use the controls at the bottom of the page to navigate through the list.

Sort Options

When the Layout setting is Table, issues in the list are shown in a table with a column for each of the fields that have been added from the Visible Fields menu. The sort options in the header row let you choose which value is used to order the issues and the direction in which they are sorted.

When filtering the list of issues in query mode, you also have the ability to specify sort attributes directly in the search query. This sorting takes precedence over the manual sorting applied using the controls in the header row. This gives you the ability to specify the primary sort criteria in the query and use the controls in the header to apply secondary sort criteria.

To learn more about sorting search results using query parameters, see Sorting by Relevance and Sort Attributes.

When the Layout setting is List, controls for setting the sort order are shown at the top of the list.

This collection of controls lets you sort the issues in the list using a wide range of sort criteria. The default sort order depends on the search type.

• If all the arguments in the search query are attribute-based, the issues are sorted by last update, in descending order.

• If the query searches for text, issues are sorted by relevance.

To apply a different sort order, click the current sort options in the toolbar. This opens the Sort Attributes menu.

The following controls are available in this menu:

To learn more about sorting search results in the Issues list, see Sorting by Relevance and Sort Attributes.

Manually Ordered Lists

When you work with issues in the Issues list, you have the option to sort these issues manually. Many teams use this functionality to prioritize issues in their product backlog or simply agree to resolve issues in a specific order.

Issues that are sorted in a custom order are represented by a vertical line to the left of the list. This line indicates where the custom order begins and ends.

Manual sorting is only available when the search context is set to a project, saved search, or tag.

• If you are manually reordering issues in a project, the permission Update Project must be enabled for your role.

• If you are the owner of the project, saved search, or tag, the custom sort order is visible to any user who has access to issues in the project or has permission to view and use the saved search or tag. The custom order is shown when the user sets the context to the project, saved search, or tag.

• If you are not the owner of the project, saved search, or tag, the custom sort order is stored locally for your user account. Other users can set and use their own custom order for the list, separate from the order you apply to your local copy.

To learn more about manually sorting issues, see Reorder Issues Manually.

Visible Fields

The Visible Fields menu lets you manage how you work with issues that match the current search query or filter criteria.

Visible fields are configured differently depending on your current layout.

Layout	Configuration
List	The Visible Fields panel shows the list of fields that are currently visible in the list. When the search context is empty, the list shows any field in any project that is currently visible in the Issues list for your account. To remove a field from the views that you work with on a regular basis, you can either select a project in the search context or restrict the set of visible fields to a specific project in the Visible Fields menu. To remove a field from the Issues list, click the Remove field icon next to the field in the Visible Fields menu. To add a field to the Issues list, click the Add field link and select the field that you want to show. Values for custom fields are only visible when the level of detail is set to M (compact) or L (detailed).
Table	The Visible Fields menu displays a list of available fields. Select an item from the list to add it as a column to the table. Drag a field by its handle to rearrange the columns. Click the icon to dynamically sort the list of issues based on the value for the corresponding field. Click the icon to remove the column from the table.

• When the Layout is List, the Visible Fields panel shows the list of fields that are currently visible in the list.

  Use the Add field option to find the fields you want to add

Settings

The Settings menu has various options you can use to customize the look and feel of the Issues page.

Layout

This setting determines whether items matching the search query are displayed in a table or as a list.

Setting	Description
Table	This setting lets you view issues in a tabular layout. The column header row contains the names of various issue attributes and custom fields. The current selection of columns is managed using the Visible Fields list. After adding a field to the table, you can sort the list of issues dynamically by clicking the icon in the header. Click once to sort in ascending order and again for descending order.
List	This setting lets you view issues as a list. You can sort the list by selecting an attribute from the Sorted by list or by adding a sort parameter to your search query. With this layout, you have access to an additional Scale option. This determines the level of detail shown in the list.

Scale

This control is only visible when the Layout is List. The slider lets you select one of three levels of detail. These levels are represented by the letters S (one-line), M (compact), and L (detailed).

The following table describes what level of detail is available for each size.

Size	Description
S	Each issue is shown on a single line in the list. In this view, the following information is shown for each issue: The value that is stored in the Priority field, represented as an icon. The issue ID. The issue summary. Issue visibility restrictions are indicated by the icon. The list of tags that are attached to the issue. If there are more tags attached to the issue than can be shown on one line, you see a single tag with a counter. This counter tells you how many additional tags are hidden. To view these tags, move your pointer over the counter. The presence of one or more attachments is indicated by the icon. The counter to the left of the icon shows you the total number of attachments for each issue. Move your pointer over the icon to view attachment thumbnails. The presence of one or more comments is indicated by the icon. The counter to the left of the icon shows you the total number of comments for each issue. Click this icon to show the most recent comments for a single issue. You can also add a new comment in the expanded view. The counter to the left of the vote icon shows you the total number of votes for each issue. If you can vote for the issue, the icon is enabled. The indicates that you have already voted for the issue. Click this icon to take your vote back. The number of votes for an issue. The date of the most recent issue update. When you move the pointer over this field, the full date and time and the name of the user who updated the issue are shown.
M	This view displays the same information that is visible in S mode, with a second line that shows values for custom fields and a link to the user who reported the issue. The set of custom fields that are shown for each issue is determined by your Visible Fields settings. To learn more about these settings, see Visible Fields.
L	This view shows the highest level of detail. In addition to the information that is visible in M mode, you see the first two to three lines of the issue description.

Preview

To view additional information for single issues, select an issue from the list. Available options for viewing single issues are based on the current selection for the Preview setting.

Setting	Description
Sidebar	When the Preview setting is Sidebar, the issue detail is shown in a preview panel. To open the issue in single issue view, click the issue ID.
Inline	When the Preview setting is Inline, use the following actions to view additional information for single issues: Click the View issue icon (or press the Right Arrow key) to expand the detail for the current issue and view the complete description. When you expand a second issue, the previously expanded issue collapses automatically. Double-click an issue (or press the F3 key) to open and view a single issue.

When the Preview setting is switched off, clicking the issue ID or summary link opens the corresponding issue in single issue view. To learn more about working with single issues, see Single Issue View.

Live Updates

Issues that are currently visible in the Issues list are updated in real time. You can see changes applied to the summary, description, and custom fields without refreshing the page. You also see incremental updates to the counters for attachments, comments, and votes and changes when other users add or remove tags.

However, you won't see any changes applied to the search results or issue counters. When you first open the page or enter a search query, the issues that match the current search context and search query are shown and sorted either in the default order or in the order that is specified by the query.

• When a change is applied that causes an issue to stop matching the current search criteria, the change is shown in the issue, but the issue is not removed from the list.

• Similarly, when a change causes an issue to match the query, it is not added to the list in real time.

• Changes that would cause an issue to appear higher in the list are also shown in each issue, but the sort order is not updated.

To realize updates that affect the search results, you need to refresh the page or re-execute the search query.