YouTrack Standalone 2017.3 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
SettingDescription
Columns are identified byDetermines which field is used to identify columns on the board. You can only select from fields that store a state or enum type with the Multi-value option disabled. That is, the field that identifies columns can only have one value set at a time. 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 the Merge Board Columns page.
Add columnThe drop-down list with the set of values for the field that defines columns.
SwimlanesDetermines which issues or attributes are used as swimlanes on the 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.

You can also use projects to identify swimlanes.

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.
ValuesLists which values are displayed as swimlanes. Use the Add value option to select which values are used to identify swimlanes.
Show swimlane for uncategorized cardsDisplays an additional swimlane for uncategorized cards. 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: 8 November 2017