descriptionCustomize how work flows through your next-gen project. Learn how to add, change, or remove the transitions between your issue's statuses.
descriptionCustomize how requests flow through your service project. Learn how to add, change, or remove the transitions between your request’s statuses.

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

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

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 next-gen projects.

Transitions control how request flows through your project. They connect your request’s statuses and describe the action your team takes when moving a request between statuses. They can also power up your project by performing automated actions.

Transitions relate to your request types' workflows and you can edit them in the workflow editor. Read more about workflows in next-gen projects.

Transitions become particularly powerful when you add rules to them. Rules automate repetitive actions when agents move requests between statuses. Read more about workflow rules.

You must have the administrator role in your project to do the things described on this page. Learn more about next-gen 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.

  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 making edits to your issue type’s workflow, select Save and close from the workflow toolbar.

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.

Create a transition in your request type’s workflow

To create a new transition:

  1. From your project's sidebar, select Service project settings > Request types.

  2. From the sidebar, select the request 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.

  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 making edits to your request type’s workflow, select Save and close from the workflow toolbar.

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 Save and close from the workflow toolbar.

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.

Edit a transition in your request type’s workflow

To edit a transition:

  1. From your project's sidebar, select Service project settings > Request types.

  2. From the sidebar, select the request 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 editing your request type’s workflow, select Save and close from the workflow toolbar.

Take care when editing transitions. If you limit how people can move requests through a workflow – for example, by editing an Any status transition to a more restrictive transition – your service team may have trouble moving a request into the correct status.

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 Save and close from the workflow toolbar.

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.

Delete a transition in your request type’s workflow

To delete a transition:

  1. From your project's sidebar, select Service project settings > Request types.

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

  3. Select Edit workflow.

  4. Select the transition in your workflow diagram. 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 Save and close from the workflow toolbar.

Take care when deleting transitions. If you limit how people can move requests through a workflow – for example, by removing Any status transitions – your service team may have trouble moving a request into the correct status. For example, if you remove all transitions from a status, you won’t be able to move requests into or out of that status at all.