How to Manage Workflow in Jira

This post was originally published on Smart Checklist for Jira blog

There are thousands of hundreds of teams in this world. Big and small, distributed and in-house, software, and non-software. Add to it the fact that no two teams are identical; you’ll realize that their workflows also come in all levels of complexity. With Jira’s workflows, putting together your custom process is simple, yet so powerful.

In this article, you’ll learn the ins and outs of Jira workflows, why it’s essential to have a custom workflow, how to create one, and make the best of Jira issues using checklists.

What Is a Jira Workflow?

A Jira workflow defines your process and lists all the steps (statuses) that a task goes through – from start to finish. More about statuses later.

Jira Workflows are the behind-the-scenes process of your tasks. From start to finish, they list all the steps that the issue walks through using statuses (more on statuses later).

Why Do Custom Workflows Matter?

The goal of custom workflows is to create a transparent and visualized process that meets your company’s needs on one Kanban board. It also simplifies communication in an organization and provides an overview of a project’s or sprint’s progress.

Jira comes with ready-to-use workflows to copy and use for your project, for example, Jira Core for project management which lets you define issues as To Do, In Progress and Done.

In reality, however, things get far more complicated than just these three statuses. You know the drill, tasks need to be reviewed, tested, approved, or even put on hold. So, it’s better to build your custom workflow and adapt it to the way your team works – precisely.

Another reason for customizing workflows is the fact that “one workflow simply won’t fit all needs”. To state the obvious: what works for software development teams, will not work for content teams or customer support teams.

What Are the Building Blocks of a Workflow?

Now, let’s break a Jira workflow into pieces and look closely at each. A Jira workflow has four main parts: a status, a transition, an assignee, and a resolution.

Statuses
Statuses describe the current stage of the task – it can be “In Progress”, “Accepted”, “Reopened” or “Done”. There can’t be two statuses for one task at the same time.

Once again, the way you customize your statuses depends on what your team needs. For example, the “In Negotiation” (if we’re talking about leads) status will make perfect sense for a sales team workflow, it wouldn’t be of much use for the QA team.

Assignees
An assignee is a person responsible for something. Just as an issue can have more than one assignee, every status can have its own assignee. Meaning, a developer will be responsible for writing the code of a new feature when the issue is “In Progress”, but it’s the QA Specialist that takes it over when it’s “Ready for Testing”.

Transitions
Transitions are the links between statuses. A transition is exactly what it takes for the issue to go from one status to another. You can compare it to driving down a one-way road from point A to point B, a transition between two statuses will be that road linking them together.

For example, between “In Progress” and “Done” you may need a transition named “Reviewed.” As a Jira Admin, you can prevent users from transitioning issues, either all of them or chosen ones.

Resolutions
Resolutions are the last stage of the issue’s workflow journey. They specify why an issue is closed, like “Done”, “Published”, or “Fixed”.

Here’s a tip on how not to use resolutions and why – don’t create an “Unresolved” resolution. This is because Jira displays any issues without a set resolution field as “Unresolved” by default. As a result, “Unresolved” issues are treated as a “Resolved”.

How to Create a Jira Workflow

Let’s get under the hood of Jira and see how to create your own custom workflow following the steps below.

1. Add Statuses and name them.
2. Define Transitions between Statuses.
3. Add Workflow Conditions to control who can execute transitions.
4. Set Validators that check if the information is valid before an issue transitions to its destination status.
5. Configure automatic Triggers to automatically transition issues. For example, move an issue from “In Review” to “Done” when the code review has been closed.
6. Apply Workflow Properties to the workflow. You can, for example, prevent users from logging work when an issue has a certain status.
7. Add a Workflow Scheme and assign your workflow to it. At this point, Jira will also ask you to assign issues types to your workflow.
8. Done!

Enrich your Jira Issues With a Checklist

How many times have you felt the urge to just “tick things off” in a Jira task? With Smart Checklist for Jira, you can create checklists and edit them the way you want to keep things more organized.

1. Once installed, the Smart Checklist option will be available for all your Jira issues at the bottom of the right-hand panel, but you can move it to the center. Click Open Smart Checklist.
   
   2.You can start adding your checklist items one by one or click the Pen icon to edit the entire list in the Fullscreen Editor.
   
   3.In the Fullscreen Editor you can use Markdown features to customize every item on the list. For example, to mark an item as “To do” put a hyphen “-” before it. As you format your list, please don’t put spaces between the text and the markdown. Otherwise, the text will not display correctly in the Jira issue. Other options include:
   –to do
   +done
   ~in progress
   xcanceled
2. Apart from displaying items with different statuses, Smart Checklist also allows you to mention teammates and highlight dates on lists. As in the screenshot above, to mention a person, use “@”, dates get highlighted automatically. However, please remember that the person you tagged will not get an automatic notification.

Last but not least, if you’re using Smart Checklist on a Jira Server, you can use our Postfunction “Smart Checklist Modify Workflow” to update your Smart Checklists upon workflow transitions.

We can describe it in these three simple steps:

• A Jira a workflow transition is executed.
• A request is triggered.
• A specified action on the checklist is done, for example, to add or to replace an item on the checklist.
• You can also read more about it here.

You can also read more about it here.
5. Once you’re done editing, hit Save and view your Checklist in all its glory.

Summary

Jira workflows is a vast topic that we could go on about. We hope that by covering why it’s important to have custom workflows and how to enrich them with a Smart Checklist, managing your work will be as easy as it goes.

Photo: Will Porada on Unsplash