Redesigned Full Page View
We’ve restyled the presentation for displaying single issues. This view supports Markdown, checklists, a dark theme, distraction-free mode, activity stream, and the ability to download all attachments. The comments, issue history, time tracking, and VCS changes have been consolidated into a single activity stream with options to show or hide specific event types.
The following animation shows the difference between the full page view before and after the redesign.
This feature is available on an experimental basis. Unlike other experimental features, the redesigned full page view is available to all users and can be activated on a per-user basis. The Link to new FSI option on the Features Configuration page only determines whether users see the Try experimental view control in the issue toolbar. To learn how to enable this option, see Experimental Features.
Accessing the Updated Issue View
When the Link to new FSI option is enabled, each page contains a button that lets you toggle between the (old) classic view and the (new) experimental version. You can store which version you want to show by default in your profile.
To set the default view in your profile:
- Click your avatar and select Profile.
- In the Workspace settings on the General tab, enable the Use experimental version of full page issue view by default option.
- The default issue view is saved in your profile.
- Whenever you open an issue in full page view, the experimental version of the page is shown.
You can revert to the older version of the page at any time by clicking the Switch back to classic view button in the toolbar.
The primary motivation for the redesign was to support additional functionality in full page view. The experimental version of the page includes support for the features that are described below.
The biggest update from a technical perspective is that 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 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.
Checklists in Markdown
While Markdown syntax is also supported in the previous version, the new page was designed with Markdown in mind. The extension that supports checklists is fully supported in updated issue views. When added to an issue description, comment, or work item, a checklist with interactive checkboxes is displayed in the issue.
For more information, see Checklists in Markdown.
The Toggle theme button in the toolbar lets you switch from the normal presentation to a dark theme.
Many users find that a palette-shifted presentation is easier on the eyes when working at night.
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.
Even though the custom fields are hidden, you can still open the Apply Command dialog with your keyboard and update the values using commands.
Possibly the biggest change in the new layout for issues is the activity stream. This view consolidates information that was presented on separate tabs into a single, 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:
The following filters are shown in the toolbar at the top of the activity stream:
|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.|
|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.|
|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.|
Sort Options in Activity Stream
One of the major changes that has been implemented with the activity stream is the ability to sort events in reverse-chronological order. You can select whether to show activity from newest to oldest or vice versa.
The following options are available from the Activity settings menu:
|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.|
|Show permalink||Displays a link to the issue with the set of filters that are currently active.|
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).
Enter your search query in the input field to show a list or matching issues.
In the previous version, a list of issues that are linked to the current issue was displayed in its own tab below the issue description. This list is now shown in the same overlay that is used for quick search.
Just below the issue summary, you see links to issues that are linked to the current issue. These links are arranged by issue link type.
- When you click the name of the issue link type, the list of issues that are linked to the current issue with this link type is displayed in the overlay.
- For issues with multiple link types, you see a link icon. Clicking the icon shows a list of all issues that are linked to the current issue with any issue link type.
In either case, YouTrack simply opens the quick search overlay with a predefined query.
Relevant information is often contained in external files that are attached to an issue. In the updated full page view, there is a dedicated menu for managing attachments.
The following options are available from the Attachments menu:
|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 window 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.|
Apart from the new features that are supported in the new full page view, there are several minor updates that improve its overall usability.
Starting at the top of the page, there are a few handy updates to the search functionality.
- 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.
- The visual indicators that are applied to the query have been updated. 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 search query is shown inline with the search bar.
One of the biggest changes from a visual perspective is that the content area for the issue summary, description, and activity stream has been extended utilize more visible space on the page. This plus the ability to filter out event types in the activity stream helps you see more information on the page without scrolling.
One drawback is that the issue content and the sidebar for custom fields are on opposite sides of the page. For issues with short summaries and little or no content in the description, you end up with a large, white void in the middle of the page.
Many users who participated in internal testing of the feature found that the new layout works best with the old option to show custom fields on the left side of the page. This consolidates all of the important information and can be scanned at a glance.
To modify the layout for your account, open your profile and enable the Show fields pane on the left option in the Workspace settings.
The options that are shown in the toolbar have been grouped and rearranged. A new Show more button displays a list of additional actions. This menu also contains custom actions that are supported by workflows.
Quick Copy Options
Clickable controls to the left of the page let you copy the issue ID and summary or description to the dashboard.
Voters, Watchers, and Boards
Next to the controls that let you view the list of voters, watchers, and agile boards, new controls let you apply updates with fewer clicks.
The following controls have been added to the page:
|Vote||Adds your vote to the list of voters.|
|Watch||Adds you to the list of watchers. This action also adds the Star tag to the issue for your account.|
|Boards||Opens the Apply Command dialog with the |