YouTrack Standalone 2019.2 Help

Single Issue View

The single issue view displays all of the information related to an issue. Here's an overview of the functionality that is supported in this issue view.

Live Updates

In single issue view, updates are applied to issues in real time. When another user applies a change to an issue that you are currently viewing, the update is shown immediately. If the update is added to a section of the activity stream that is not currently visible in your web browser, a notification is shown at the bottom of the page.

If changes are applied to an issue that is open in an inactive browser tab, you are notified that there are updates available and prompted to refresh the page.

Live update full page view

The search bar is displayed in the single issue view.

Search bar single issue view jpg

This shows you the search context and query that determine which issues are shown and can be displayed by navigating between issues in this view.

  • The search context includes a visible input field to filter items in the list.

  • The query completion highlights search attributes that match the current input.

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

  • The counter for issues that match the current search query is shown inline to the right the search bar.

When you access an issue from the Issues list, the following options are available in the search bar:

Option

Description

Go back to search

Navigates back to show issues that match the current search query in the Issues list.

Previous issue

Navigates to the previous issue in the list that matches the search query.

Next issue

Navigates to the next issue in the list that matches the search query.

To learn more about search queries, see Search.

Issue Toolbar

The single issue view includes a toolbar that lets you apply specific actions to the current issue.

Issue toolbar single issue view jpg

The following controls are available in single issue view:

Control

Description

Open command dialog

Opens a dialog that lets you apply one or more commands to the current issue. For a list of supported commands, see Command Reference.

Link issue

Opens a list from which you can select an issue link type. When you select an issue link type, a dialog for linking the current issue to one or more target issues opens.

Add tag

Opens a list of tags that are available to you. Select a tag from the list to add the tag to the current issue.

Assign

Opens a list of users to whom the issue can be assigned. Select a user from the list to update the value in the Assignee field.

Show more

Displays a list of additional actions. This menu also contains custom actions that are supported by workflows.

For details, see Show More Menu.

Edit issue

Opens the issue in edit mode. Here, you can change the basic properties of the issue, such as the Project, Summary, and Description. You also have access to set or change the values for supplemental text fields.

Show More Menu

The following actions are available from the Show more menu:

Issue toolbar show more menu

Control

Description

Custom actions

The first items in the Show more menu are custom actions that are supported by workflows. The set of actions that are available in each issue is determined by the workflows that are attached to the current project. For more information, see Action Rules.

Clone issue

Creates a copy of the current issue. For more information, see Clone Issues.

Print issue

Opens the issue on a printer-friendly page. Use the Print command in your browser to print the page.

Attach files

Opens a dialog that lets you locate and attach a file from your local directory.

Attach files privately

Opens the Attach Files Privately dialog. Here, you have the option to restrict the visibility for all files to specific groups and/or users.

Use this option for files that contain sensitive information.

Find similar issues

Opens a list of issues that are similar to the current issue in a new browser tab. The Issues list uses the looks like search attribute to find issues with similar words in the issue summary in description. For more information, see Find Similar Issues.

Repeat last command

Open the Apply Command dialog with the most recent command in the input field.

Distraction-free Mode

The Toggle distraction-free mode button in the toolbar hides the menu and search bar in the header as well as the sidebar for custom fields. This lets you focus on the issue description and the content in the activity stream.

This view mode is extremely useful when your description contains a lot of text, as the content is presented in the full width of the page.

Distraction free mode

Even though the custom fields are hidden, you can still open the Apply Command dialog with your keyboard and update the values using commands.

Tags

Just below the toolbar, you'll find a list of tags that are currently attached to the issue.

Single issue view tags
  • To add a tag, click the Add tag button in the toolbar or use the add tag <tag name> command.

  • To remove a tag, click the Remove tag icon inside the tag or use the remove tag <tag name> command.

or more information about tags, see Tag Issues.

Issue Details

The single issue view displays detailed information for the current issue.

Single issue view details

The following issue details are shown in the body of the page:

Item

Description

Issue ID

Displays the ID of the issue.

Created by

Displays the full name of the user who reported the issue. The date and time the issue was reported is also shown. Click the name to open the profile page for this user.

Updated by

Displays the full name of the user who last updated the issue. The date and time of the last update is also shown. Click the name to open the profile page for this user.

Visible to

Displays the current visibility setting for the issue. For issues with restricted visibility, the lock icon is displayed to the left of this label. Click the link to set or change the visibility of the issue.

For more information, see Issue Visibility.

Issue Summary

Displays the summary of the issue. You can update this information in edit mode.

Issue Description

Displays the description of the issue. You can update this information in edit mode.

Quick Copy Options

Clickable controls to the left of the page let you copy the issue ID and summary or description to the dashboard.

Quick copy options

These controls are shown when you move your pointer over the element that you want to copy.

Star Tag

To the left of the issue summary is a control that lets you add the Star tag to the issue. This action also adds you to the list of watchers.

Single issue view star tag

Click the icon a second time to stop watching the issue.

For more information, see Watch Issues.

Voters

To the right of the issue summary is a control that lets you vote for an issue and view the list of voters.

Voters list
  • Click the Vote icon to vote for an issue. If you are the reporter for the current issue, this control is disabled.

  • When an issue has one or more votes, a counter is shown to the left of the Vote icon. Click the counter to show the list of users who have voted for the issue.

For more information, see Vote for Issues.

Supplemental Text Fields

Single issue view supports a new type of custom field for text. These fields store a string of characters that is interpreted in Markdown syntax when shown in the issue.

Fields with this type are not shown in the sidebar with other custom fields. Instead, they appear just below the issue description.

Text field single issue view

As with the issue summary and description, you can only change the values for text-based fields when an issue is open in create or edit mode. When editing these fields, a preview of the input is shown as formatted in Markdown. For a complete list of formatting options, see Markdown Syntax.

Text field preview

Otherwise, working with supplemental text fields is just like any other custom field in YouTrack.

This panel displays a list of issues that are linked to the current issue. It is only visible when the current issue is linked to at least one issue. When this panel is hidden, you can either use the Link issue button in the toolbar to link to other issues or use the syntax add <link type> <target issue> to link to other issues with a command.

  • The toolbar displays counters for each issue link type. A tooltip for each counter shows the total number of issues that are linked to the current issue with this link type. The tooltip also tells you how many linked issues are unresolved.

  • All of the issues that are linked to the current issue are displayed as a list, grouped by issue link type.

  • Unresolved issues are shown higher in the list.

  • The height of the panel is restricted. You can scroll to view more linked issues, click the tabs to show issues by link type, or click the expand control at the bottom of the panel to show all linked issues.

Single issue view links

The following controls are available in this panel:

Control

Description

Show/Hide linked issues

Collapses and expands the list of linked issuesd issues to display only issues with comments.

Link issue

Opens a list of issues in a dialog that lets you link one or more issues to the current issue. Use the search box in the dialog to filter the list.

View linked issues in Issues list

Opens a list of linked issues in a new browser tab.

expand/collapse

Expands and collapses the issue links panel.

For each issue that is linked to the current issue, you see an icon that represents the issue priority, the issue ID and summary, and the current number of votes and comments. Click the link for the ID and summary to open a linked issue in single issue view.

The following options are available for each issue in the linked issues panel:

Option

Description

Star issue

Adds the Star tag to the linked issue. This action also adds you to the list of watchers.

For more information, see Watch Issues.

Vote for issue

Adds you to the list of voters for an issue. If you are the reporter for the linked issue, this control is disabled.

For more information, see Vote for Issues.

Remove link

Removes the link between the current issue and the linked issue.

For more information, see Link Issues.

Attachments

Relevant information is often contained in external files that are attached to an issue. The files that are attached the current issue are shown as thumbnails in the attachments panel.

Single issue attachments

Here, you also find a dedicated menu for managing attachments.

Download all images

The following options are available from the Attachments menu:

Option

Description

Download all

Just like you'd expect, this downloads all of the files that are attached to the issue to your local directory as a ZIP archive.

Open all images in new tab

Displays all of the image files that are attached to the issue in a new browser tab.

Add files

Opens a dialog that lets you locate and attach a file from your local directory.

Add files privately

Opens the Attach Files Privately dialog. Here, you have the option to restrict the visibility for all files to specific groups and/or users.

Use this option for files that contain sensitive information.

For more information, see Attach Files.

Activity Stream

The activity stream at the bottom of the page provides a chronological list of changes that have been applied to the issue. The filters at the top of the list let you select which types of changes you want to show or hide.

Here's an example of the activity stream filtered to show comments and VCS changes:

Activity stream

The following filters are shown in the toolbar at the top of the activity stream:

Filter

Description

Comments

Toggles the visibility of comments in the activity stream.

Spent time

Toggles the visibility of work items. This control is only visible when the Time Tracking feature is enabled in the project.

For details, see Enable Time Tracking.

Issue history

Toggles the visibility of the issue change history.

VCS changes

Toggles the visibility of VCS changes that have been linked to the issue. This control is only visible when the project is integrated with a version control system or is connected to a VCS through an integration with TeamCity.

For details, see Connect to a VCS and Integrate with TeamCity.

Code reviews

Toggles the visibility of activities related to a code review in Upsource. This control is only visible when an integration with Upsource is configured for the project.

For details, see Upsource Integration.

For more information about the updates that are shown in the activity stream, see View Issue Updates.

The Activity settings menu stores your preferences for viewing items in the activity stream. You can select whether to show activity from newest to oldest or vice versa.

The following options are available from the Activity settings menu:

Control

Description

Sort: oldest first

Displays changes in chronological order. The input field for comments, work items, and manual commits is shown at the bottom of the page.

Sort: newest first

Displays changes in reverse-chronological order. In this mode, the input field for comments, work items, and manual commits is displayed at the top of the activity stream.

Expand issue history items

When enabled, each issue history item is expanded automatically. Otherwise, issue history items with more than one line of information are collapsed.

Show permalink

Displays a link to the issue with the set of filters that are currently active.

Fields Panel

The panel to the right of the issue detail displays additional information related to the current issue.

Single issue fields panel

The following information is shown in this section of the page:

Item

Description

Custom Fields

This section displays the custom fields that are attached to the project and the current values that are set for each field. Click a value to select or enter a new value for the field.

Watchers

Displays the number of users who are watching the issue.

  • Click the down arrow to display a list of users who are watching the issue. If you have the Update Watchers permission in the project, you can add or remove other users in the list.

  • Click the Watch issue link to add yourself to the list of watchers. This action also adds the Star tag to the issue for your account.

Boards

Displays the list of agile boards that the current issue appears on.

  • Click the down arrow to display the list of boards.

  • Click the Add to board link to open the Apply Command dialog and add the issue to a board with a command.

There's an option in your YouTrack profile that lets you move the fields panel to the left side of the page. Many users who participated in internal testing of the feature found that the current layout works best with this option enabled. This consolidates all of the important information to the left of the page where it can be scanned at a glance.

Fields pane left

To move the fields panel:

  1. Click your avatar and select the Profile link.

  2. On the General Settings tab, enable the Show fields pane on the left option.

    • Your profile settings are updated

    • When you open a new issue or refresh an open page in single issue view, the fields panel is displayed to the left of the issue detail.

Quick Search Overlay

You can now execute a search request without navigating away from the current issue to the Issues list. To open the search overlay, press Ctrl + K (Windows) or + K (macOS).

Search overlay

Enter your search query in the input field to show a list or matching issues.

For a complete list of search terms and parameters, see Search Query Reference.

Last modified: 17 December 2019