YouTrack InCloud 2018.1 Help

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:

  1. Click your avatar and select Profile.
  2. In the Workspace settings on the General tab, enable the Use experimental version of full page issue view by default option.
    enable experimental issue view
    • 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.

Major Updates

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.

Live Updates

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.

live update full page view

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.

checklists new full page view

For more information, see Checklists in Markdown.

Dark Theme

The Toggle theme button in the toolbar lets you switch from the normal presentation to a dark theme.

dark theme full page view

Many users find that a palette-shifted presentation is easier on the eyes when working at night.

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.

Activity Stream

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:

activity stream

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

CommentsToggles the visibility of comments in the activity stream.
Spent timeToggles the visibility of work items. This control is only visible when the Time Tracking feature is enabled in the project.
Issue historyToggles the visibility of the issue change history.
VCS changesToggles 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 reviewsToggles 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 firstDisplays changes in chronological order. The input field for comments, work items, and manual commits is shown at the bottom of the page.
Sort: newest firstDisplays 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 permalinkDisplays 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).

search overlay

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

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

issue links by 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.
    linked issues by link type
  • 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.
    all linked issues

In either case, YouTrack simply opens the quick search overlay with a predefined query.

Attachments Menu

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.

download all images

The following options are available from the Attachments menu:

Download allJust 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 tabDisplays all of the image files that are attached to the issue in a new browser tab.
Add filesOpens a window that lets you locate and attach a file from your local directory.
Add files privatelyOpens the Attach Files Privately dialog. Here, you have the option to restrict the visibility for all files to specific groups and/or users.

Minor Changes

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.

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

Expanded Layout

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.

fields pane left

To modify the layout for your account, open your profile and enable the Show fields pane on the left option in the Workspace settings.

Issue Toolbar

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.

issue toolbar

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

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.

voters watchers boards

The following controls have been added to the page:

VoteAdds your vote to the list of voters.
WatchAdds you to the list of watchers. This action also adds the Star tag to the issue for your account.
BoardsOpens the Apply Command dialog with the add Board command pre-filled. To add the issue to an agile board, select a board from the list and (when required) enter the name of the sprint.
Last modified: 20 March 2018