• Products
  • Documentation
  • Resources

Transition an issue

We’re currently updating how you transition issues with workflow screens your admin has mapped out

You may notice the following improvements:

  1. Adding comments using the new ADF editor, and yes, that includes Atlassian Intelligence

  2. Comments on service projects will default to internal visibility

  3. Reference existing attachments when adding new comments

  4. Search for specific values inside fields

  5. Confirmation toast when an issue is transitioned successfully or fails

  6. Modern look and feel and so much more!

For more information about these updates, read our community post.

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 Configure columns.

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 will respect your workflow configuration, and will trigger all your 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.

Transition an open issue

Transitioning an issue can mean moving it to another status, or performing a "looped" transition where the transition allows you to perform an action but keep the issue in its current status. We refer to these looped transitions as issue actions.

To transition an issue to a new status:

  1. Select the Status menu at the top of the issue.

  2. Select the new status for the issue.

You can also see the issue workflow by selecting View workflow.

The workflow status dropdown in a company-managed project with the statuses: In progress, backlog, selected for dev, done.

To perform an issue action (looped transition):

If you only have one action, select the name of the action at the top of the issue.

If you have more than one issue action:

  1. Select Actions at the top of the issue.

  2. Select the action to perform.

Screenshot of global looped transition dropdown in Jira Cloud

You can perform this action with your keyboard via Jira’s command palette. Use command + K (for Mac) or Ctrl + K (for Windows) to open the command palette while you’re in Jira. Learn more about Jira’s command palette

You must log in as a user with the Administer Jira global permission to edit workflows. For more information, see Work with issue workflows.

Transition linked issues and subtasks

If the issue you're working on has subtasks or linked issues, you can transition them without having to leave the issue you're viewing. Select the status of a linked issue or subtask and choose the relevant status or transition.

Transition a subtask to another status by using the dropdown in the issue view.

Transition on a board

  1. Select the Jira icon > Projects > then select the relevant project.

  2. In the Active sprints (Scrum projects) or on the Kanban board (Kanban projects), transition an issue by dragging and dropping the issue from one column to another.

  3. If a dialog box opens for your workflow transition status, complete all mandatory fields (indicated by a red asterisk) before submitting the form.

If the target column is associated with more than one status, when you hover the issue over that column, each possible status will appear as a separate section. Complete the transition to the appropriate status by dropping the issue onto the section of the column.

Transition multiple issues on a board

To transition multiple issues:

  1. Select the issues you want to transition. You can do this by holding the Shift key to select a group of adjacent issues or by holding Ctrl (Windows) or Command (Mac) while selecting issues.

  2. Select More actions () > Bulk change.

  3. This will open the original bulk change experience where you can transition your issues.

Transition issues with subtasks in the Kanban backlog

  • To transition both the parent issue and its subtasks, drag and drop the parent issue while it's collapsed to the corresponding section.

  • To transition just the parent issue or a subtask, expand the parent issue first, then drag and drop only the parent issue or the sub-task to the corresponding section.

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

Transition multiple issues from the backlog

To transition multiple issues from the backlog, select the issues you want to transition first. To do this, you can either:

  • use the issue checkboxes

  • hold Ctrl (Windows) or Command (Mac) while selecting issues

  • hold the Shift key to select a group of adjacent issues

Once you have selected issues, you can transition them:

  1. Select Edit > Fields from the toolbar that appears.

  2. Select a status from the dropdown. If your selected issues don’t share the same statuses or transitions, this will open the bulk edit sidebar. Issues from the same workflow will be grouped together and you can select a new status for each group.

If you need to transition issues to a status that requires transition screens, you can use our original bulk change experience.

To transition issues with the original bulk change experience:

  1. Select the issues you want to transition.

  2. Select More actions () > Bulk change.

  3. This will open the original bulk change experience where you can transition your issues.


Still need help?

The Atlassian Community is here for you.