JetBrains Space Help

Create and Configure an Issue Board

Create an issue board

  1. Open your project.

  2. On the Projects sidebar, click Issue Boards.

    • If your project has no boards, click Build an issue board.

    • If your project already has a board, and you want to add another one, click the existing board name and choose New board:

    addIssueBoard.png
  3. Enter the board's name and click Create:

    boardName.png

    That's it. A new board is created with the default configuration where columns are mapped to the existing issue statuses.

Edit an issue board

You can: edit a board's name, description, and configure columns:

  1. Open the board you want to edit.

  2. On the top right, click Settings:

    issueBoardClickSettings.png
  3. Navigate to the respective tabs to edit Board info or configure Columns, Cards, Swimlanes.

  4. Edit the settings and click Save when done.

Configure issue board columns

By default, the number of columns matches the number of issue statuses defined in the issue settings and each column is mapped to and named after a particular status:

boardSettingsDefault.png

You can change the mapping in many ways:

  • Give a column a custom name.

  • Change the order of columns (left to right) by dragging them (top to bottom).

  • Add or remove columns.

  • Combine different statuses into one column.

Here is an example where we renamed the board columns:

boardSettingsCustom1.png

In this other example we had a custom issue status configuration to start with and decided to map two different statuses to one of the columns:

boardSettingsCustom2.png

Configure issue board swimlanes

Swimlanes ia a way of grouping issues on the board by a selected attribute (issue field). You can organize issues by assignee, due date, creation date, creator, or any custom field.

For example, swimlanes can be used to help your teammates track high-priority issues by showing them at the top of the board, or group different subsystems or products your team is working on into a single board.

To add swimlanes to the board, select an issue field as a swimlane category:

issueBoardSettingsSwimlanes.png

In this example, the issues are grouped by Assignee:

swimlanes.png

Configure issue board cards

On an issue board, issues are displayed as cards. You can choose what attributes will be shown on each card: such as issue ID, status, due date, attachment preview, or other issue fields.

issueBoardSettingsCards.png
Last modified: 17 February 2023