YouTrack Standalone 2018.2 Help

Agile Board Settings

The Board Settings panel is divided into four tabs. Each tab lets you manage a specific set of parameters for the board. To open the Board Settings panel, click the icon Cog button in the toolbar.

General

The General tab lets you manage the basic settings of the board. Most of these settings are defined when you create the board.

The Board behavior options let you manage how issues are added to your board. There are different sets of options for boards with sprints and boards without sprints. For more information, see Board Behavior.

boardSettingsGeneral thumbnail
SettingDescription
NameDisplays the name of the board. You can reference the name of the board in commands to add issues to or remove issues from the board. You can also reference the name of the board in search queries.
owned byDisplays the name of the user who created the agile board. To change the owner, select another user from the drop-down list.
  • If the previous owner is not a member of a group that can view and use the board, this user no longer has access to this board.
  • If the previous owner is not a member of a group that can change board settings, this user can no longer access the board configuration panel.
ProjectsLists the projects that are managed on the board.
Can view and use the boardShows who has permission to view and update issues on the board. Select a group to grant its members access to the board.
  • Members of the group can view all fields and values that identify columns and swimlanes in the board settings, including private fields.
  • Any member with the Low-level Administration permission can access and edit the settings for this board as well.
Can change board settingsShows who has permission to view and update board settings.
SprintsDetermines whether the board uses sprints or not. This setting also determines which of the Board behavior options are available.
Board behaviorDefines how issues are added to the board. For a detailed description of each option, see Board Behavior.
QueryFilters which cards are visible on the board. This setting is only available when one of the following options are enabled:
SprintsBoard behavior
EnabledLink sprints to custom field
DisabledFilter cards to match a query

Columns and Rows

The Columns and Rows tab lets you to define which columns are displayed on your board and add swimlanes.

boardSettingsColumnsRows thumbnail

Settings for Columns

The first group of settings defines the columns on your board.

Columns usually represent progressive stages in the issue lifecycle.

  • Cards in the leftmost column are intended to represent unstarted effort.
  • Cards in the rightmost column represent finished work.
  • In between, the columns represent incremental progress.

The most common configuration for columns on an agile board uses values from the State field or another field that stores a state type. Use the following settings to define columns on your board:

SettingDescription
Columns are identified byDetermines which field is used to identify columns on the board. The field selection is restricted as follows:
  • You can only select from fields that store a state type or an enum type with the Multi-value option disabled. That is, the field that identifies columns can only store single values. This restriction prevents you from building a board that shows the same card in multiple columns, which is strange.
  • The selection is limited to the fields that are used in the projects that are associated with the board.
ColumnsLists which values are displayed as columns on the board. Use the Add column option to add a column from the set of values that is used in the field that identifies columns. Drag a column to change its position on the board.
WIP SettingsSets the minimum and maximum allowed WIP for a column. WIP stands for the "Work in progress" parameter — the number of cards that can be placed in the column. For example, if you use the State field for columns, then you can set that maximum 5 cards can simultaneously in the "In Progress" column/state. When the number of cards in the column is less than the "Min WIP" or is more than the "Max WIP" value, a warning is displayed in the column title. Also, the corresponding bar in the Progress indicator next to the sprint name is highlighted red.
Merge withMerges the selected column with another column on the board. For a detailed description, see Merge Board Columns.
Add columnThe drop-down list with the set of values for the field that defines columns.

Settings for Swimlanes

The second set of settings on the Columns and Rows tab lets you add structure to the board in the form of swimlanes. Swimlanes are meant to help members of an agile team prioritize their work. This can be accomplished in several ways:

  • For scrum boards, you can identify swimlanes by the user stores or features that have been taken to the current sprint. You can then drag the swimlanes to order them by priority, from the top of the board to the bottom.
  • For Kanban boards, you can identify swimlanes by values from the Priority field. The tasks on the board are automatically sorted by priority from top to bottom.

There are several other possible configurations, like using Project, Subsystem, or even Assignee. Use the following options to add swimlanes to your board:

OptionDescription
No swimlanesSwimlanes are disabled on the board.
ValuesSwimlanes are identified by the set of values in a selected Field. Select a field and add swimlanes from the list of values. For example, if you select the Type you can add swimlanes for Features, Tasks, Bugs, and so on. The field selection is restricted as follows:
  • You can use custom fields that store a state type or an enum, user, ownedField, version, or build type with the Multi-value option disabled. That is, the field that identifies swimlanes by type can only store single values. This restriction prevents you from building a board that shows the same card in multiple swimlanes, which is strange.
  • You can also select a custom field or issue attribute that stores a date. With this configuration, the swimlanes group issues into a predefined set of relative date ranges. This lets you set up an agile board that automatically sorts issues into swimlanes by due date. You can also configure swimlanes to use other date values, like creation date or last update.
  • You can identify swimlanes by project.
  • Fields that store simple types like string, period, integer, and float are not allowed. These fields store an indefinite number of values and are not practical for use as swimlanes.

When you identify swimlanes by values from a custom field, don't use the same field that identifies columns on your board. The configuration makes no sense from a logical point of view and the resulting board serves no practical purpose.

IssuesSwimlanes are identified by issues that are assigned a specific value in the selected Field. For example, a swimlane represents an issue with the Type field set to Feature. Select a field and add swimlanes from the list of values. All of the issues that are assigned the selected values are shown as swimlanes.

Unlike swimlanes that are identified by values, the swimlanes are represented by issues, not issue attributes. When you add a swimlane to the board, you create an issue that is assigned the value in the field that identifies swimlanes.

This selection is restricted to custom fields that store values as an enum, state, ownedField, version, or build. Here, it doesn't matter whether the field stores single or multiple values. Even if, for example, you identify swimlanes by issues with the value for the Version field set to 1.0 and 1.1 an issue appears as a single swimlane even when you add both versions to the Version field.

The following field types are not supported:

  • Fields that store a user type, like Assignee. If this were possible, you would end up with different swimlanes for every issue that is assigned to selected users. As soon as the issue is assigned to a user who is not selected from the list, the swimlane would disappear. It's bizarre.
  • Fields that store simple types like string, date, period, integer, and float. These fields store an indefinite number of values and are not practical for use as swimlanes.
ValuesLists which values from the field that identifies swimlanes are visible as swimlanes on the board. Use the Add value option to select which values are shown.
Show swimlane for uncategorized cardsDisplays an additional swimlane for uncategorized cards. This lets you add and manage cards that don't match the attributes or issues that define a swimlane.

This option is only available when swimlanes are enabled. You can choose to display this swimlane at the top or bottom of the board.

Card

The Cards tab lets you display estimations on the board, set the default issue type for new cards, and manage the visual presentation.

boardSettingsCard thumbnail
SettingDescription
Estimation FieldDetermines which field is used to display estimations on the board. You can only select from fields that store a period, integer, or float type.
Default Value for TypeSets the default value for the Type field when you add a card to the board. This option is only displayed when swimlanes are enabled and identified by Issues.
Color SchemeDifferentiates cards on the board by project or based on the value of a selected custom field. The default setting applies the colors scheme used by the Priority field.
  • If you select Project, you can choose which color is applied to cards in each project.
  • If you select a custom field, the color that is associated with each value in the set is applied to cards automatically.
Show colors for other custom fields.Toggles the presentation of color-coded visual indicators for the custom fields that are visible on each card.

Chart

The Chart tab defines parameters of the chart to use for the board.

boardSettingsChartBDCustom thumbnail
SettingDescription
TypeDetermines which type of chart is accessible on the board. For more information about each type, see Burndown Chart and Cumulative Flow.
Issue FilterDetermines which issues are included in the calculation of the chart:
  • All cards: All cards that are assigned to the current sprint of the board are taken into account. Swimlanes are not included in the calculation.
  • Custom: All cards and swimlanes that match the Query are taken into account.
Burndown calculated byDefines which values are used to calculate the burndown. This setting is only available for the burndown chart. Different options are shown based on the The value depends on the settings of the time tracking in the board projects:
  • Issue count: The burndown is calculated by the number of cards on the board.
  • Estimation: The burndown is calculated based on the values in the custom field that is shown for estimations on the board. When a card is moved to a resolved state, the burndown is reduced by value that is set in the Estimation field.
  • Work items: The burndown is calculated by the amount of spent time that is added to an issue as a work item. Available only if:
    • The Estimation Field setting on the Card tab is set to a field that stores a period type.
    • The Time Tracking feature is enabled and configured for at least one of the projects on the board.
Last modified: 10 July 2018