Skip to main content

Customizing the board layout

You can use the board layout to arrange your project's items over customizable columns.

About the board layout

The board layout spreads your issues, pull requests, and draft issues across customizable columns. You can create a kanban board by setting your column field to a "Status" field or set any other single select or iteration field as the column field. Moving items from column to column will adjust the value of the column field for that item.

For more information about changing a view to use the board layout, see "Changing the project layout."

Showing and hiding fields

  1. Click next to the name of the currently open view. Screenshot showing the view menu icon
  2. Under "Configuration", click and the list of currently shown fields. Screenshot showing show and hide fields menu option
  3. Select or deselect the fields you want to show or hide. Screenshot showing show and hide fields menu

Alternatively, open the project command palette by pressing Command+K (Mac) or Ctrl+K (Windows/Linux) and start typing "show", "hide", or the name of the field.

Setting the column field in board layout

In the board layout, you choose any single select or iteration field for your columns. If you drag an item to a new column, the value of that column is applied to the dragged item. For example, if you use the "Status" field for your board columns and then drag an item with a status of In progress to the Done column, the status of the item will switch to Done.

  1. Click next to the name of the currently open view. Screenshot showing the view menu icon
  2. Click Column field. Screenshot showing the column field item
  3. Click the field you want to use. Screenshot showing the column field menu

Alternatively, open the project command palette by pressing Command+K (Mac) or Ctrl+K (Windows/Linux) and start typing "Column field by."

Showing and hiding columns in board layout

In the board layout, you can can choose which columns to display. The available columns are made up of the contents of your selected column field.

  1. In the board layout, scroll to the right of your columns, and click .

    Screenshot showing the plus symbol button

  2. Select the columns you want to show.

    Screenshot showing the list of columns

Showing the sum of a number field

You can configure a view to show the sum of one of more number fields, including a count of items in the group or column. For example, if you have a number field tracking the number of hours each item may take to complete, you can display of sum of those hours for each group or column.

In a board layout, field sums are displayed at the top of each column. In table and roadmap layouts, when you enable grouping by a field, field sums are included in each group's header.

  1. Click next to the name of the currently open view. Screenshot showing the view menu icon

  2. Click Field sum.

    Screenshot showing the field sum menu item

  3. Select the fields you want to include.

    Screenshot showing the field sum menu