Mastering Jira Workflows: A Step‑by‑Step Configuration Guide

Jira plays a pivotal role in project management thanks to its powerful workflow support, allowing teams to fully customize steps, transitions, conditions, and permissions.

1. Create a Workflow

Users with system admin rights navigate to the workflow section and click Add Workflow , entering a name and confirming.

After creation, the workflow detail page opens where steps can be added either in text mode or graphic mode.

1.2 Create a Workflow Scheme

A workflow scheme groups workflows and links them to issue types. In the issue module, select Workflow Schemes , click Add Scheme , name it (e.g., SC_workflow), and save.

Within the scheme, the default workflow can be edited or removed, and new workflows can be added.

1.3 Associate Scheme with a Project

Open the target project, go to the workflow section, click Switch Scheme , select the newly created scheme (e.g., SCflow), and confirm the association.

Workflow Management Overview

Workflows define issue flow, events, permissions, and validations. Configuration includes statuses, transitions, conditions, validators, post‑functions, and screen schemes.

2.1 Statuses

Statuses are nodes in a workflow. Define each status (e.g., To Do, In Progress, Done) and indicate whether it is a start, in‑progress, or end status. Avoid duplicate names, as changes affect all workflows that reference the status.

2.2 Workflow Configuration (Text Mode)

Select an existing workflow (e.g., SCflow) and click Edit to open the configuration page.

Add steps, link them to statuses, and define workflow actions (e.g., "Reject Review"). Configure each action’s screen, target step, and any required fields.

Actions can be edited or deleted, and multiple actions can be selected for batch deletion.

2.3 Workflow Configuration (Graphic Mode)

Switch to the graphic editor to drag‑and‑drop statuses and transitions.

Click a status to edit its properties or to connect it with another status, defining conditions such as required assignee or specific roles.

When transitioning from a non‑completed to a completed status (or vice‑versa), ensure the resolution field is updated accordingly to avoid inconsistent issue states.

Final Tips

After editing, remember to publish the workflow. The configuration options are extensive; hands‑on experimentation is the best way to become proficient.