Transitioning an issue

Before you begin

Before you can transition issues to columns on a board, your JIRA administrator or board administrator will have already mapped workflow statuses to your board's columns. To know more about configuring these mappings, see Configuring columns. Also, you can only transition an issue if you have project permission to move that issue to the status in the JIRA workflow to which the column is mapped.

JIRA Software will respect your JIRA workflow configuration, and will trigger all your JIRA workflow validations, conditions, functions, and notifications when you transition issues (See Workflows for more information.) However, note that boards currently don't auto-assign issues to you.

To transition an issue to a different JIRA workflow status on a board:

  1. Click Boards (in header) > select your desired board.
  2. In the Active sprints (Scrum board) or Kanban board (Kanban board), transition an issue by dragging and dropping the issue from one column to another.
    When you start dragging an issue, you can only transition the issue to columns whose backgrounds turn blue. When the issue is hovered over the target column, the blue background turns green.
  3. If the target column is associated with more than one status, when you hover the issue over that column, each status will appear as a separate section with a dashed outline. Complete the transition to the appropriate status by dropping the issue onto the section of the column.
  4. If a dialog box opens for your workflow transition status, you must complete all mandatory fields (indicated by a red asterisk) before submitting the form.

  When transitioning multiple issues...

Depending on the following conditions, you can transition multiple issues from the backlog to the next status in your project's workflow:

  • You have the transition issues permission.
  • The statuses of the issues are already mapped to the board's columns.
  • Your project's workflow supports the particular transition for the multiple issues selected, and all transition conditions are met.
  • The issues you're transitioning have the same set of transitions.
  • The issues you're transitioning don't have any associated transition screen.
  • You can select multiple issues by using the Shift or Ctrl key while clicking the issues.

  When transitioning issues that have sub-tasks in the Kanban backlog...

  • To transition both the parent issue and its sub-tasks, drag and drop the parent issue while it's collapsed to the corresponding section.
  • To transition just the parent issue or a sub-task, expand the parent issue first, then drag and drop only the parent issue or the sub-task to the corresponding section.

  • If all sub-tasks of an issue have been completed, you need to resolve the parent issue itself. When you move the last sub-task to the 'Done' column, JIRA Software will prompt you to move the parent issue as well. If you resolved the sub-tasks in native JIRA Software instead, a button will be displayed on the parent issue the next time you visit the Active sprints page.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport