Skip to main content

This version of GitHub Enterprise Server was discontinued on 2024-03-26. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise Server. For help with the upgrade, contact GitHub Enterprise support.

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.

You can drag items from column to column and the value of the item will adjust to match the column you drag them to.

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

Showing and hiding fields

  1. Click next to the name of the currently open view.

    Screenshot showing the tabs at the top of a project. The view menu icon is highlighted with an orange outline.

  2. Under "Configuration", click Fields.

  3. Select or deselect the fields you want to show or hide.

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 tabs at the top of a project. The view menu icon is highlighted with an orange outline.

  2. Click Column field.

  3. Click the field you want to use.

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