Create workflow transitions

Workflows in Jira define how work items move between statuses. Transitions define which statuses a work item can move to from its current status.

For a work item to move between two statuses, a transition must exist. Transitions are also one-way. To move a work item back and forth, you need two separate transitions.

Transitions can also loop, so the work item's status stays the same. This is useful for opening transition screens or triggering actions without changing the status.

This page focuses on transitions. Read more about editing a workflow's statuses, rules, or resolutions.

Add transitions to an existing workflow

Access an existing workflow

Create a transition

To add a transition, open your workflow:

1. [設定] () > [作業項目] の順に選択します。

2. Select Workflows, then for the workflow you want to update, select More actions (), then Edit to open a diagram of your workflow.

3. Select Add transition () in the page header.

4. Select the From status and To status, and name the transition, then select Add.

   1. Or, you can drag a line between two statuses in the diagram to create a transition.

To view active transitions in company-managed spaces, open a work item, select the status, and choose View workflow from the dropdown.

Transition work items from any status

You can also set up the transition so that work items can move between any statuses.

For example, if a work item has the status In review, from the details panel, select the option to Allow work items in any status to transition to this one. Then, if someone wants to move the work item back into To do or over to Done, they can do so without restriction.

Add a looped transition to perform transition actions

You can use a transition to move a work item to another status, or, you can set up a looped transition so when the work item transitions, it performs an action, but the status doesn’t change. We refer to these looped transitions as work item actions.

To add a work item action:

1. Select Add transition

2. Select From status, then select Any status for the action to be available from all statuses, or select the specific status you want to loop.

3. Select To status, and choose the status to loop.

4. Give the transition a name, then select Add.

5. From here, you can add Perform action rules (or post-functions in the old editor) to trigger a particular event when the work item action is used. More on advanced workflow configurations.

This is how actions appear on a work item:

Set the resolution field

In Jira, a work item is either open or closed, based on the value of its Resolution field (not its status).

• A work item is open if its resolution field isn't set.

• A work item is closed if its resolution field has a value (for example, Fixed or Can't reproduce).

This is true regardless of the work item’s current status (like, Open or In progress). If you need your workflow to force a work item to be open or closed, you will need to set the resolution field of the work item during a transition.

Rename workflow transition buttons

If you copied the system workflow and you wish to rename the workflow transition buttons when you View work item, you must delete the following properties from all transitions in the copied workflow:

• jira.i18n.title

• jira.i18n.description

そうではない場合は、既定の名前 (これらのプロパティの値) が引き続き使用されます。トランジション プロパティの詳細をお読みください。