YouTrack Server 2022.1 Help

Agile Board User Interface

An agile board in YouTrack has a number of controls that you can use to update issues or modify the appearance of the board.

Header

agile board header

The Create button at the top of the page lets you perform the following actions.

Action

Description

Card

Opens a dialog for adding an issue as a card to the board.

  • On boards that identify swimlanes by values in a field, the card is added to the swimlane that corresponds to the value that is assigned to the new issue for this field.

  • On boards that identify swimlanes by issues, the card is added to the swimlane for uncategorized cards.

Swimlane

Opens a dialog for adding an issue as a swimlane on the board. When created, the new swimlane is added to the bottom of the board. This option is not visible on agile boards that identify swimlanes by values in a field.

Sprint

Opens the New Sprint dialog. This option is only visible if sprints are enabled and you have permission to update the settings of the current board. For more information, see Create a Sprint.

Board

Opens the Create an Agile Board page. For more information, see Create an Agile Board.

The following controls are displayed just below the header.

Control

Description

Board name

Displays the name of the current board. Enter a value in the input field to filter the list of boards. To view a different board, select its name from the drop-down list.

Filter

Filters the cards on the board. Like the search bar, this filter supports query completion. When the backlog is visible, the filter criteria is applied to the issues in the backlog. Press Enter or click the Search icon to apply the filter. Click the Remove icon to remove the filter and display all of the cards on the board.

Board List

The section of the header that displays the name of the current agile board is also a list. This list grants access to any agile board that you can view and use.

agile boards list

This list shows the name of each board as well as its owner. To the right of the board owner, there's an icon that lets you add the corresponding board your list of favorites. Your favorite boards are shown at the top of the list. When you click this icon for a board that is already marked as a favorite, the board is removed from your list of favorites.

Toolbar

The toolbar is always displayed at the top of the page when you scroll down the board.

agile toolbar

The following controls and visual indicators are displayed in the toolbar for all agile boards.

Control

Description

Backlog

Opens the list of issues in the backlog on the left side of the page. For more information, see Work with a Backlog.

Progress indicator

Displays the total number of cards in each column on the board as a bar chart. Move the pointer over each bar to display the total number of cards and the value that is assigned to each column.

Unresolved issues link

This link opens a list of issues that are assigned to the board but do not match any of the attributes that are used to define columns and swimlanes. This can help you find issues that are assigned values that no longer match the values that identify columns and swimlanes on the board. You can then choose whether you want to add and merge values with existing columns or add more swimlanes.

Card size

Sets the level of detail for cards on the board. This setting is user-specific and can be set independently for different boards.

TV mode

Opens the board in full screen mode. TV mode is optimized for display on large monitors and can be read from a greater distance than normal mode.

Chart

Opens the chart that is configured to track progress on the board. The type of chart that is displayed is determined by the Chart settings for the board. If you have permission to update the board settings, additional controls let you recalculate the report, edit the chart settings, and print the report. Otherwise, you can only view the settings and print the report.

Board settings

Opens the Board Settings panel. If you do not have permission to update the board settings, this control is disabled.

The following controls are only visible on agile boards that use sprints.

Agile toolbar sprints

Control

Description

Sprint name

Displays the name of the current sprint. To view a different sprint, select its name from the drop-down list. Enter a value in the input field to filter the list of sprints. If you have permission to update the settings of the current board, you can also select the New sprint option to add a sprint to the board.

Sprint schedule

Displays the start and end date of the current sprint. This control is only visible when the schedule has been defined for the sprint. If you have permission to update the settings of the current board, you can click the drop-down menu to change the schedule. Otherwise, this control is disabled.

Sprint countdown

Displays the number of calendar days remaining in the current sprint. This total includes non-working days. On the last day of the sprint, this indicator only displays the checkered flag. This information is only visible when the schedule has been defined for the sprint.

Estimation

Displays the total estimation for all of the cards on the board. The presentation varies based on the data type of the custom field that is used as the Estimation field in the board settings. This information is only visible when the Estimation Field setting is configured.

Columns

Agile board columns

The label for each column corresponds to a value in the custom field that identifies columns on the board.

The following controls and visual indicators are displayed in the header of each column.

Control

Description

Show/hide column

Click the column label to collapse or expand the column on the board.

Open in Issues list

Click to open the Issues list in a new browser tab. This control is visible when you move the pointer over the column header. The Issues list is filtered to show issues that match the search criteria for the selected column.

Total estimation

Displays the total estimation for all cards in the column. The presentation varies based on the data type of the custom field that is used as the Estimation Field in the board settings. This information is only visible when the Estimation Field setting is configured. If the Estimation Field for the board is not set, this indicator displays the total number of cards in the column. Move the pointer over the indicator to display the total number of cards in the column.

Swimlanes

agile swimlane

Each row on the board represents a swimlane.

  • For boards that use issues to identify swimlanes, the issue summary is displayed as the label for the swimlane.

  • Boards that use values in a custom field to identify swimlanes show the value that is stored in the selected field.

All boards have an option to show a swimlane for uncategorized cards. This swimlane can be placed at the top or the bottom of the board. Use this swimlane to manage issues that do not belong to a specific swimlane.

The following controls and visual indicators are displayed in each swimlane.

Control

Description

Reorder swimlane

Drag to move the swimlane to a new position on the board.

Issue ID

Click to open the issue that identifies the swimlane on the board in single issue view. This control is only visible on boards that use issues to identify swimlanes.

Update issue

Click to open the issue that identifies the swimlane in view mode on the board. This control is only visible on boards that use issues to identify swimlanes.

Show/hide swimlane

Click the arrow icon or swimlane label to collapse or expand the swimlane.

Total cards

Displays the total number of cards that are assigned to the swimlane.

Estimation

Displays the total estimation for all of the cards that are assigned to the swimlane. The presentation varies based on the data type of the custom field that is used as the Estimation Field in the board settings. This information is only visible when the Estimation Field setting is configured.

Add a card

Opens a dialog to add an issue as a card to the selected column and swimlane. Values for the fields that identify the corresponding column and swimlane are set automatically and cannot be changed in this dialog.

Cards

Agile card

Each card represents an issue on the board. When you drag a card to a different column or swimlane, the fields that are used to identify these components of the board are updated in the issue. The amount of information that is displayed on each card is determined by the current setting in the Card Size slider.

The visual presentation of each card changes in the following ways:

  • The current card on the board is shown with a blue boarder. In this state, keyboard shortcuts and commands are applied to the current card.

  • A card that is selected before moving to another card on the board is displayed with a blue background. In this state, keyboard shortcuts and commands are applied to all selected cards. The current card is not considered.

The following controls and visual indicators are displayed on each card.

Control

Description

Card Sizes

Issue ID

Click to open that issue that is represented by the card in single issue view.

S, M, L, XL, TV

Custom fields

Displays values for the first three custom fields in the project, excluding fields that are used in the board settings and Assignee. Click to set or change the current value. If you have permission to update the set of values for the projects on the board, an additional option to add a value to the custom field is visible.

M, L, XL, TV

Issue summary

Displays the issue summary. On small and medium cards, the summary is truncated to the first two lines. Large and extra large cards show the first three lines.

S, M, L, XL, TV

Issue description

Displays the first three lines of the issue description.

XL

Tags

Displays the tags that are attached to the issue. The card displays as many tags that can be shown in one line.

L, XL, TV

Assignee

Displays the avatar of the user who is set as the current assignee. If the issue that is represented by the card is unassigned, the Set assignee button lets you select a user from the list of assignees in the project.

S, M, L, XL, TV

Attachments

Displays the number of attachments that have been added to the issue.

M, L, XL, TV

Estimation

Displays the value that is set for the estimation field. Click to set or change this value.

S, M, L, XL, TV

Backlog

The backlog is a set of issues that await planning and implementation. In other words, it is the collection of unfinished work that your development team can build to improve the product. Teams normally prioritize issues in the backlog to determine which issues are addressed in each release cycle.

In YouTrack, the collection of issues that are displayed in the backlog on an agile board is represented by a saved search. For more information, see Work with a Backlog.

Charts

Agile boards offer two types of charts that you can use to monitor your progress over time. The board settings determine which chart is displayed when you click the Chart button in the toolbar. Based on the configuration for the current board, one of these two charts are shown when you click this button:

Chart

Description

Burndown

A burndown chart compares ideal versus real effort remaining and can help indicate whether the team is on track for completing a sprint.

Cumulative Flow

A cumulative flow diagram shows the distribution of cards by stages. For a kanban board or an unscheduled sprint, the chart is calculated for the last two weeks.

agile footer

Like the toolbar, the footer is always visible on the agile board.

The following controls and visual indicators are displayed in the footer.

Control

Description

Board owner

Displays the full name of the user who created the board. Click the link to open the user profile of the board owner.

Sprint goal

Displays the goal of the current sprint.

New swimlane

Opens a dialog to add an issue to the board as a swimlane. This control is only visible on boards that use issues to identify swimlanes.

Agile footer selection

The following controls are displayed in the footer when you select one or more cards on the board.

Control

Description

Selected cards

Displays the number of cards that are currently selected on the board. Click the x icon to clear the selection.

Clear selection

Clears the selection of cards on the board.

Assignee

Lets you change the assignee for all of the selected cards. Select a user to set or change the assignee for all of the selected cards.

Add tag

Opens the list of tags. Select a tag to add the tag to all of the selected cards.

Add link

Opens the list of issue link types. Select an issue link type to open the Apply Command dialog and add a link type to all of the selected cards.

Move to next sprint

Moves all of the selected cards to the next sprint. This control is only visible on agile boards with sprints enabled.

  • If the next sprint has not been scheduled, this control opens the New Sprint dialog. When you create the sprint, the selected cards are added to the new sprint.

  • If the next sprint has been scheduled, this control opens the Apply Command dialog. The command to move the selected issues to the next sprint is entered in the input field automatically. Apply the command to move the selected cards to the next sprint.

The drop-down list next to this control lets you move the selected cards to a specific sprint or return them to the backlog.

Last modified: 06 July 2022