descriptionCustomize how work flows through your team-managed project. Learn how to add, change, or remove the transitions between your issue's statuses.

Are you on the right help page?

The following information only applies to team-managed projects.

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

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 types' workflows and you can edit them in the workflow editor. Read more about workflows in team-managed projects.

You must have the administrator role in your project to do the things described on this page. Learn more about team-managed project roles.

Create a transition in your issue type’s workflow

To create a new transition:

  1. From your project's sidebar, select Project settings > Issue types.

  2. From the sidebar, select the issue type you want to edit.

  3. Select Edit workflow.

  4. Using the toolbar at the top of the editor, select Transition.

  5. Select the start of your transition path in the From status dropdown. Select multiple statuses to create a shared transition.

  6. Select the destination of your transition path in the To status dropdown.

  7. Give your transition a name.

  8. 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 doIn progressIn reviewDone

There’s a transition from In reviewDone named Complete work that your team wants to use to go from In progressDone 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:

  1. From your project's sidebar, select Project settings > Issue types.

  2. From the sidebar, select the issue type you want to edit.

  3. Select Edit workflow.

  4. Select the transition you want to add a status to.

  5. Open the From status dropdown.

  6. 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:

  1. From your project's sidebar, select Project settings > Issue types.

  2. From the sidebar, select the issue type you want to edit.

  3. Select Edit workflow.

  4. 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:

  1. From your project's sidebar, select Project settings > Issue types.

  2. From the sidebar, select the issue type you want to edit.

  3. Select Edit workflow.

  4. At the bottom of the details panel, select gram. The transition details panel appears.

  5. 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.

Take care when deleting transitions. If you limit how people can move issues across the board – for example, by removing Any status transitions. Your team may encounter errors when they move cards across your board.

Take care when restricting who can move an issue. If you remove the roles or people designated in this rule, your team may have trouble moving issues into the correct status.