YouTrack Standalone 2021.2 Help

Viewing Articles

When you select an item in the table of contents, the corresponding article is displayed in the content area of the page.

The following options and controls help you browse and read the content that is stored in your YouTrack knowledge base.

Table of Contents

The table of contents to the left side of the page lets you see where the article has been placed in the hierarchical content tree. The content is organized by project.

The sidebar that shows articles grouped by project in a table of contents.

The list of projects is filtered to show only projects that contain at least one article. To add articles to a project that is not shown in the table of contents, start a new draft and assign it to any project where you have permission to create an article. For more information, see Create an Article.

The section of the page above the main content area displays a so-called breadcrumb trail. These navigation links show the hierarchical location of the current page in relation to other articles in the project.

Breadcrumb navigation for an article in the knowledge base.
  • The first link corresponds with the project that the article belongs to. When you select another project from the drop-down list, the current article and all of its parent articles are moved to the selected project.

  • Intermediary links correspond with the parents of the current article. Clicking one of these links displays the corresponding parent article in the content area.

  • The right-most link shows the ID for the current article. Move your pointer to the right of this link to reveal a control that lets you copy the article ID and title to the clipboard.

Article Metadata

YouTrack displays the basic information about the article at the top of the content area, just below the breadcrumb navigation.

Metadata for an article in the knowledge base.

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

  • The name and avatar of the user who created the article and its creation date.

    Move your pointer over these elements to see the exact date and time the article was created and the profile card of the article author.

  • The name and avatar of the user who applied the most recent update to the article. Updates include changes to the article content, its position in the table of contents, file attachments, or comments.

    Move your pointer over these elements to see the exact date and time the update was applied and the profile card of the user who applied the change.

Visibility Restrictions

The current visibility restrictions are shown to the right of the article metadata.

Visibility restriction options for an article in the knowledge base.

By default, an article is visible to any user who has the Read Project Basic and Read Article permission in a particular project.

  • If the visibility for the article is not constrained, it is shown as Visible to article readers.

  • If the article inherits visibility restrictions from one of its parent articles, it is shown as having inherited restrictions.

When you click to expand this control, you can further restrict the visibility of the current article to a specific set of users, groups, and teams.

For further details, see Manage Article Access.

Article Actions

A handful of convenient actions are supported by controls that are shown in line with the article title.

Available actions for articles in view mode.
ActionDescription
Add to favorites

Adds the current article to your list of favorites.

This option subscribes you to notifications for article updates according to the notification settings for the Star tag in your YouTrack profile. For details, see Notifications.

EditOpens the article in edit mode.
Show moreDisplays a list of additional actions. A description of each action is provided in the table below.
Toggle text width

Switches between the two available modes for viewing article content.

  • Full width extends the text to fit the entire content area. Use this mode to display content that doesn't fit within the restricted standard width.

  • Standard width restricts the text to a width that is optimal for reading comfortably.

Additional actions are available from the Show more menu:

ActionDescription
Copy article IDCopies the current article ID to the clipboard.
Print articleOpens the article in a printer-friendly page. Use the Print command in your browser to print the article.
Show version historyOpens the version history for the current article. To learn more about this feature, see Review Version History.
Delete articleDeletes the current article and removes it from the knowledge base.

Activity Stream

The section of the page below the body of the article displays a list of comments and changes in a single feed that we call the activity stream. The activity stream has filters that let you select which types of changes you want to show or hide.

The activity stream for an article in the knowledge base.

The following controls are available in the toolbar at the top of the activity stream:

ControlDescription
CommentsToggles the visibility of comments in the activity stream. To learn more about issue comments, see Add Comments.
Article historyToggles the visibility of the issue change history. This feed contains all of the updates that are applied to the issue.

The following options are available from the Activity settings menu:

ControlDescription
Sort: oldest firstDisplays changes in chronological order.
Sort: newest firstDisplays changes in reverse-chronological order. In this mode, the input field for comments is displayed at the top of the activity stream.
Last modified: 09 July 2021