Transitioning an issue

A common theme that we see in support is confusion over the error "No transitions to specified status could be found for issues". While this error message seems to indicate that the status doesn't exist, it often means something different.

Transitions must follow Workflows

One of the common mistakes that people make is a transition in a rule that violates the project's workflow, meaning that the transition from the current status to the status specified in the rule isn't allowed. If you're not too familiar with Workflows then you can find a good explanation in the Jira Support Documentation.

In the example Workflow below is a custom workflow for investigating and handling bugs: Example Workflow

This workflow will restrict what can be done with the Transition Issue action.

For example, take a rule with a manual trigger that comments when a bug is a duplicate - and then closes it by transitioning it to "Done": Example Rule

From the workflow diagram, the example rule will not successfully execute on issues that are in the "Awaiting Triage" state, as issues can only go from there to "Under Investigation".

A rule run on a ticket in this state will result in an errors status: Example Error

However, this rule can be run on issues in the "Under Investigation" and "In Progress" statuses as the workflow will allow transition from these statuses to "Done".

Rule actors need the correct permissions

Another common mistake is not taking into account the permissions of the rule actor. The rule actor is set on the rule details section of a rule and is the user that the rule runs under. Your rule actor may be in a different set of groups to yourself and not have the right permissions for transitioning your issues.

Using the example in the previous section, looking at the details of the transition from "Selected for Development" to "In Progress" we can see that there is a condition attached to making this transition: Example Transition with Condition

Developers are the only users that fix the bugs, so this condition ensures that they are the only users able to make this transition: Example Condition

I have created an example rule which, using webhooks, will transition the issue to "In Progress" when the developer creates a branch on GitHub: Example Actor Rule

In its current form this rule will fail as I am not part of the developers group: Example Condition Error

Changing the rule actor to one in the developers group will allow this rule to run successfully.