Get started with next-gen projects

Are you on the right help page?

The following information only applies to next-gen projects.

To check which type project you need help with, look at the bottom of your project’s left-hand sidebar:

  • If you see an icon stating You’re in a next-gen project with Give feedback and Learn more menu items, you're in a next-gen project.

  • If you don't, you're in a classic project. Check out our classic project documentation.

Create a next-gen project

All users can create a next-gen project, even non-admins. If you're a Jira admin and you want to restrict this, you'll need to remove the Create next-gen projects permission. For more information on global permissions, see Managing global permissions.

To try out a next-gen project:

  1. Choose ProjectsCreate project

  2. In Choose project type > click Select next-gen

  3. Under Template, select Change template and choose either Scrum or Kanban

An option to Create project is also available in the top-right corner when you view all projects.

What is the board?

If you have the Sprints feature enabled, your board won't show any issues until you start a sprint.

Usually, your board reflects your team’s process, tracking the status of work it makes its way through your team’s process.

To view your board:

  1. If not already there, navigate to your next-gen project.

  2. From your project’s sidebar, select Board.

Your project’s board displays your team’s work as cards that you can move between columns. In Jira Software, cards and the tasks they represent are called “issues”.

The columns on your board represent the status of these tasks. This visual representation of your team’s work helps you discuss and track the progress of your project from start to finish.

While the roadmap can help you plan and track large initiatives over weeks, months, and quarters, the board is more tactical. It gives you a status of the work your team is currently carrying out, usually over the next week or two.

In next-gen Jira Software projects, your board comes with three default statuses. Each status is associated with a column position on the board:

  • To do, associated with the leftmost column on the board

  • In progress

  • Done, associated with the rightmost column on the board

Cards in the leftmost column on your board are always categorized as to do, meaning no progress has started on carrying out the task. Issues in this column will have the To do status. Cards in the rightmost column of your board are always categorized as resolved, meaning all work has been completed and the task has been carried out. Issues in this column will have the Done status.

If you’ve enabled the sprints feature, these issues won’t return to the backlog when you complete your sprint. If you don’t have the sprints feature enabled, these issues are automatically removed from the board after 14 days.

We recommend this lightweight process for starting your project. As your team matures, you may need to add more columns to better control the flow of your team’s work.

Create issues

Besides the Create button in the navigation bar, you can quickly create issues directly on your next-gen board and in your next-gen backlog.

Create issues on the board

If you have the Sprints feature enabled, you won't be able to create issues directly on the board; you can only create issues on the backlog, and then add them to the sprint.

Issues represent tasks to be completed. Create issues in any of your board's columns so your team can track work progress.

An annotated board with 2 issues. 1 is a plus sign, used to create new issues, 2 is the issue type, 3 is the create button.

To create an issue on your board:

  1. Select the Create issue button at the bottom of any column.

  2. Fill in the required information that answers What needs to be done?

  3. Select the issue type icon on the card to recategorize the task.

  4. Select Create.

We recommend keeping an issue's summary both short and descriptive so your team can scan the board quickly to get an overview of each other’s work.

Other quick ways to create issues on the board

  • In any position on your board: Add an issue in the middle of a column by hovering your mouse between two issues and selecting .

A cropped "in progress" column on a board. The mouse cursor hovers between 2 issues to show a plus sign (create new issue)


  • Create multiple issues at once: On your board, select and paste several lines of text into the box to create an issue for each line. This is especially useful if you want to create issues from a spreadsheet!

A cropped image of a to do column in a board. A text field has 7 lines of text. A dialogue box suggests creating 7 issues.

Try to keep an issue's details both short and descriptive. Team members should be able to scan the board quickly and get an overview of their team's work. 

Create issues in the backlog

Select Backlog in the project menu on the left and hit Create issue to add an issue to your backlog. 

Use the backlog list in to create tasks for your team to take on in the future.

Add, edit, rearrange, and delete columns

You can edit or rearrange columns so the board accurately reflects your team’s process.

To update a status’s name, click the column’s name. To rearrange your columns, drag and drop the column’s heading.

To add a new status column, click the Create column button beside the rightmost column. The newly created column will have an In progress status. Drag and drop the new status column to incorporate it into your workflow.

Cards in the first column on your board (from left to right) are always categorized as to do, meaning no progress has started on carrying out the task.

Cards in the rightmost column of your board are always categorized as done, meaning all work has been completed and the task has been carried out. If you’ve enabled the sprints feature, these issues won’t return to the backlog when you complete your sprint. If you don’t have the sprints feature enabled, these issues are automatically removed from the board after 14 days.

Resolved issues have a checkmark on them, like this:

A cropped issue card displaying a green tick, title, and issue key.

To mark issues as resolved, the Done status must be in the rightmost position on your board. Double-check the status column order whenever you update your board’s columns.

To delete a status column, hover over the column’s heading and select More () > Delete. If you delete a column that contains issues, you can select where to move those issues. Issues in your backlog will also inherit that status.

If you work in a Kanban style, you can limit the amount of work you allow in any one column. Hover over the column’s heading and select More () > Set column limit.

Your board will always need a Done status column (and your team probably does, too!). If you decide to delete your Done column, the column you choose to move its issues to will become your new Done status column.

Move issues between columns

As work is completed, you'll want to move issues across your board, to indicate progress. Drag and drop an issue to move it. You can select multiple issues with either the Ctrl (Windows) or Command (Mac) key. Once you've selected multiple issues, you can move them all to a new column, or perform other actions by selecting .

Add images to issues

Quickly and easily add images to issues, and choose your favorite to display as the preview on the board:

  1. Open an issue by clicking on it.

  2. Click Add attachment ().

  3. By default, the first image you add will display as the preview. Change it by hovering over a different image and clicking Show on card.

A full issue view. The cursor hovers over a paperclip icon, to show the text: Add attachment.
  • Edit or annotate images after they've been attached by hovering over an image and clicking the paintbrush icon.

  • To hide a preview image from displaying on the board, hover over the image and click Hide on card.

  • Switch off the entire feature by going to your board's settings () and clicking Hide cover images.

Choose the best view for your board

As your team works with the board, you might find that you need to cut through the noise to find exactly the right things to pick up and work on, or see what your team is up to.

Next-gen project boards have some default grouping and filtering that can help you get a better visual of your team’s work:

An annotated Jira next-gen board. Callouts are: 1 board members profile pics, 2 a drop down menu, 3 another drop down menu.
  1. Assignee filter: Display only issues containing a search term, or assigned to a specific person, and hide the rest.

  2. Other filters: Display only issues that contain specific labels or epics, and hide the rest.

  3. Group by: List issues under swimlanes based on the chosen category. 

Clear Done issues from your board

If you work in a Kanban style, you can keep your board tidy by manually clearing the issues in your Done column.

If you have the Sprints feature enabled, you won’t be able to manually clear issues from your board.

Clearing done issues from a next-gen Kanban board.

To manually clear Done issues from your board, hover over the Done column and select More (…) > Clear Done issues.

Only project admins and Jira admins can clear Done issues.

Issues will be automatically cleared from your board 14 days after being moved to the Done column.

Once an issue is cleared, it will no longer appear on your board. To view cleared issues, click See all Done issues in the Done column, or enable the project issue navigator and select the Done filter.

Read more about searching for issues.

Learn more

If you want to learn more or want to ask us about Jira Software's next-gen projects, join the discussion at Atlassian Community.

Anyone can create a next-gen project (unless your Jira admin has implemented a permissions scheme requiring you to have certain permissions). You will, however, need administrator permissions to create classic Scrum and Kanban projects.

Last modified on Dec 11, 2020
Cached at 3:38 PM on Jan 21, 2021 |

Additional Help

Ask the Community