Creating a board

On this page

In this section

Still need help?

The Atlassian Community is here for you.

Ask the community

You need a board so that you can view and work on issues in Jira Software. A board displays issues from one or more projects. You can either copy a board that someone else has created, or create a new board for yourself. You can also create as many boards as you like.

There are two types of boards:

  • Scrum: For teams that plan their work in sprints. This project template delivers a board and a backlog.
  • Kanban: For teams that focus on managing and constraining their work-in-progress. Kanban boards don't have a separate backlog view by default. Initially, you use the first column of the board as your backlog, and as your team grows, or if you're planning for many issues for your team, you can choose to enable the Kanban backlog. This way, you get a bigger space to plan work for your team.
  • Next-gen Scrum/Kanban*For teams who are new to agile or Jira Software. Get your team up-and-running with this simplified board-view project template. The set-up is straight-forward and streamlined, delivering more power progressively as you need it. Anyone can create these.

    *Power and functionality is being progressively added to next-gen boards. Stay up-to-date with the latest features here.

tip/resting Created with Sketch.

Learn more: What is a board?

On this page:

Before you begin

Any user can create an agility board, but to share a board with other users, you'll need certain permissions:

  • If you create a board via Search icon (sidebar) > View all boards, you won't be able to share it, unless you have the Share dashboards and filters global permission.
  • If you create a board via the following methods, you don't need the Share dashboards and filters global permission to share the board:
    • Creating a project, where a board is created for the project by default.
    • Setting up Jira Software for the first time, where you're prompted to create a project, which also creates a board for the project.
    • Copying a board, where the copied board will be shared with the same users as the original board.

Create a new board

If you're setting up Jira Software for the first time, follow the prompts to create a project. A new board may already be selected for your project by default. Click Change to view all options.


If you've already set up Jira Software, and you want to create a new board:

  1. Click Search  (in the global sidebar) > View all boards.
  2. Click Create board at the top-right of the page, and choose whether to create an agility board, Scrum board, or Kanban board, as described below.

    With Scrum and Kanban boards, you can't change the board type after creation—a Scrum board can't become a Kanban board, and vice versa. (Next-gen boards, however, are more flexible.)

    To create a Scrum board based on projects

    a. Click Create a Scrum board.

    b. Select whether to base your board on a new Software project or one or more existing projects (you need the 'Browse Projects' permission for both options).

    c. Follow the prompts to set up your board and project.

    If you're basing your board on one or more existing projects, this will create a pre-configured scrum board that contains all the issues in your chosen projects. Your scrum board will have an issue filter with the following query:

    project = "[YOUR PROJECT]" ORDER BY Rank ASC
    To create a Kanban board based on projects

    a. Click Create a Kanban board.

    b. Select whether to base your board on a new Software project or one or more existing projects (you need the 'Browse Projects' permission for both options).

    c. Follow the prompts to set up your board and project.

    If you're basing your board on one or more existing projects, this will create a pre-configured Kanban board that contains all the issues in your chosen projects. Your Kanban board will have an issue filter with the following query:

    project = "[YOUR PROJECT]" ORDER BY Rank ASC
    To create a Scrum or Kanban board based on filters

    Before you begin: You must have access to at least one saved issue filter — either your own filter, or one that someone else has shared with you. If you don't, you need to create and save a new issue filter first (see the documentation on JQL).

    Click Create a Scrum board or Create a Kanban board, and base your board on an 'existing Saved Filter'. Follow the prompts to set up your board. Your new board will be available to all users who have access to your chosen filter. See the examples below for sample JQL for your board's filter.

    Note, if you are the owner of the issue filter, you can edit it via the Edit Filter link. Otherwise, this link will not appear.

  3. Your new board will be shown. At the top is a link that you may want to send to other people so that they can use your board.

Congratulations — you have created a new board!

Copy an existing board

To create a board that is similar to one you're already using, create a copy. Your new board will be based on the same issue filter as the original board.

You'll be the administrator of the new board, but not necessarily of the filter, so you may not be able to edit the filter. But once your new board is created, you can choose a different filter (to view a different project, for example). See Configuring filters.

  1. Click Search  (in the global sidebar) > View all boards.
  2. Find the board you want to copy and click ••• > Copy.

Example JQL queries for board filters

Here are a few common queries that you can use for your board's filter:

  • Select all issues that are Unscheduled or in an Unreleased Fix Version:

    project = JSW AND (fixVersion in unreleasedVersions() or fixVersion is empty
  • Select all issues you are interested in:

    (assignee = currentUser() or reporter = currentUser()) AND (fixVersion in unreleasedVersions() or fixVersion is empty)
  • Show all issues that you have participated in and have been updated in the last week. (info) This requires the Jira Toolkit add-on.

    updatedDate > -7d AND Participants = currentUser()
  • Select all issues for a team (using a Label custom field named 'Team')

    (team = ateam or team = dreamteam or team = engineroom) AND (fixVersion in unreleasedVersions() or fixVersion is empty)
  • Only select my bugs for a bugfix team

    project = JSW AND team = bugfix AND issuetype = bug AND (fixVersion in unreleasedVersions() or fixVersion is empty)
  • Try fixVersion = earliestUnreleasedVersion(PROJECT KEY) to see all issues in the next Fix Version to be released:

    fixVersion = earliestUnreleasedVersion(PROJECT KEY) 

See JQL for more information on using JQL for your board. Let your imagination run wild! 

Next steps

 Need help? If you can't find the answer you need in our documentation, we have other resources available to help you. See Getting help.


Last modified on Oct 4, 2018

Was this helpful?

Yes
No
Provide feedback about this article

In this section

Powered by Confluence and Scroll Viewport.