Get started with Jira
New to Jira? Check out our guides for new administrators and users.
Manage transitions in team-managed projects
Issue transitions control how work flows through your project. They connect your issue type’s statuses and describe the action your team takes when moving issues between statuses. They can also power up your project by performing automated actions.
Issue transitions relate to your issue type’s workflows and you can edit them in the workflow editor. Learn more about workflows in team-managed projects
You must have the administrator role in your project to do manage transitions in a team-managed project. Learn more about team-managed project roles
Create a transition in your issue type’s workflow
To create a new transition:
From your project's sidebar, select Project settings > Issue types.
From the sidebar, select the issue type you want to edit.
Select Edit workflow.
Using the toolbar at the top of the editor, select Transition.
Select the start of your transition path in the From status dropdown. Select multiple statuses to create a shared transition.
Select the destination of your transition path in the To status dropdown.
Give your transition a name.
Select Create.
Your transition appears on the workflow as an arrow connecting your statuses. When you select a status in your workflow, you can view all its transitions in the details panel.
You can add up to 200 transitions to your workflow.
When you’re done editing your issue type’s workflow, select Update workflow and confirm which issue type the workflow will apply to.
Take care when creating transitions that don’t start from Any status. These transitions may cause unintended behavior when people move cards across your board.
Add a status to an existing transition in your issue type’s workflow
If you want different ways of reaching a particular status with the same transition, you can add more From statuses to an existing transition.
Example
Your team might have a standard workflow with these statuses:
To do → In progress → In review → Done
There’s a transition from In review → Done named Complete work that your team wants to use to go from In progress → Done as well. To do this, you can add the In progress status to the Complete work transition.
The transition named Complete work will now look like this: (In progress, In review) → Done.
Create a shared transition
To add a status to an existing transition:
From your project's sidebar, select Project settings > Issue types.
From the sidebar, select the issue type you want to edit.
Select Edit workflow.
Select the transition you want to add a status to.
Open the From status dropdown.
Select more statuses.
When you’re done editing your issue type’s workflow, select Update workflow and confirm which issue type the workflow will apply to.
Edit a transition in your issue type’s workflow
To edit a transition:
From your project's sidebar, select Project settings > Issue types.
From the sidebar, select the issue type you want to edit.
Select Edit workflow.
Select the transition in your workflow diagram. The transition details panel appears.
In the details panel, you can edit the transition’s name and any of its rules.
When you’re done making edits to your issue type’s workflow, select Update workflow and confirm which issue type the workflow will apply to.
Take care when editing transitions. If you limit how people can move issues across the board – for example, by editing an Any status transition to a more restrictive transition. Your team may encounter errors when they move cards across your board.
Delete a transition in your issue type’s workflow
To delete a transition:
From your project's sidebar, select Project settings > Issue types.
From the sidebar, select the issue type you want to edit.
Select Edit workflow.
At the bottom of the details panel, select gram. The transition details panel appears.
At the bottom of the details panel, select Delete transition.
Deleting a transition also deletes any rules associated with the transition.
When you’re done making edits to your issue type’s workflow, select Update workflow and confirm which issue type the workflow will apply to.
Was this helpful?
Still need help?
The Atlassian Community is here for you.