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 backlog

The default settings display all existing issues in the backlog section of an issue board. You can change the way issues are added to the backlog:

  • Manually — issues will not appear in the backlog unless they are specifically selected. To add an issue to the board, a participant will have to click plus-add-grey.png in the backlog column and choose an issue from the list.

  • Search Query — you can set a predefined search query that will filter out unwanted issues. Only issues that satisfy your search criteria will be added to the backlog. You can customize the search query by adding or modifying issue field values, like tags.

To switch to manual adding of issues:

  1. Go to the Backlog tab.

  2. Select Manual then click Save:

    issueBoardSettingsBacklogManual.png

    The backlog will be cleared and issues need to be added manually from now on.

To switch to adding issues by predefined query:

  1. Go to the Backlog tab.

  2. Select Search Query.

  3. Create your query by applying various criteria, such as Assignee, Creation Date, Tag, etc.:

    issueBoardSettingsBacklogQuery.png
  4. Click Save.

    The backlog will be filtered and only issues that match your predefined criteria will be added to the backlog.

Configure issue board cards

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

issueBoardSettingsCards.png

You can only display issue fields which are enabled in the Issue fields settings.

Last modified: 01 November 2023