Building an awesome Jira workflow: concepts and examples

Building an awesome Jira workflow: concepts and examples

I’m amazed by how many different types of teams use Jira to manage their workflows.  Jira’s customizable workflow engine lets you adapt it to all kinds of company cultures – whether small and new, or large and legacy.

As your company grows, you develop a unique culture based on how employees work together in teams. And how a team functions is reflected in it’s workflow: a repeatable process that makes it easier for people to work together at scale.

Without a doubt, customizing a killer workflow is the key to getting the most out of Jira.

Much like trying on six pairs of shoes until you find the perfect fit, taking the time to customize your Jira workflow pays dividends down the line. So let’s walk through a few concepts and lay out some best practices for designing a custom workflow for your team.

Anatomy of a Jira workflow

A workflow has four unique components: statuses, transitions, assignees, and resolutions. To illustrate them at a conceptual level, we’ll use a well-known workflow example: that of a library. Each item a library lends out could be stored in Jira as an issue, and follow a simple workflow.

Statuses: where

Statuses indicate where an issue is within a workflow, and each status can be unique. (Your issues may flow through a given status multiple times, if you configure your transitions to be bi-directional – more on that in a moment.) In the library workflow example, a book can be in one of three places: at the library, with a customer, or retired from inventory.

Statuses come in two flavors: unresolved and resolved. At Library and With Customer would be considered open statuses, while Retired would be considered closed. Other common open statuses include Open, In Progress, In Review, Scheduled, Waiting on Customer, and Pending Analysis. Common closed statuses include Shipped, Published, Fixed, Analysis Complete, and Closed.

Transitions: what

Transitions reflect the action being taken and dictate the way an issue moves from status to status – sort of like a road connecting two cities – and can be one-way or bi-directional. You can allow issues to transition into a given status from any other status, which lets you design workflows for free-flowing processes where there are several possible next steps for an issue. Or, you can set up transitions that keep issues flowing along a tightly defined pathway to reflect more regimented processes (such as in our library workflow example).

Jira also supports workflow permissions that allow only certain people to transition an issue. At the library, books are loaned out by librarians, returned by customers, and evaluated by library staff to see if they’re fit for circulation. Note that customers cannot evaluate if an item is fit for inventory – that must be decided by the library staff.

Assignees: who

The assignee indicates the responsible party for an issue. In our library example, we would set the assignee to the borrower every time a book is loaned out so the library knows which customer has that book. When the book is returned, we would remove the assignee (in other words, set it to Unassigned) when we put the book back on its shelf.

Resolutions: why

Resolutions explain why an issue transitioned from an open status to a closed one. The act of retiring a book removes it from inventory (reflected by transitioning its issue to Retired, a closed state). So we can put a resolution on that book. We might set up resolutions like Damaged, Out of Date, or Lost.

Workflow “gotchyas” to avoid

There are two common mistakes first-time workflow designers make.  

Confusing resolution with status

Status describes where an item is in the workflow; resolution explains why an item is not in flight anymore. Think about Retired vs. Damaged. (People sometimes confuse resolution with transition, too – think Damaged vs. Retire Item.)

Pro-tip: Searching for everything that’s Retired (a resolved status), as well as why it’s been retired, provides granular reporting options. Many teams review resolved issues to ensure they are resolved for the right reasons.

Setting resolutions incorrectly

You must set a resolution when an issue moves from an unresolved state to a resolved  state. Likewise, resolution needs to be removed if an issue flows back into an unresolved state.
If our librarian decides to put a book back into circulation (i.e, taking an issue from Retired to At Library via the Restore to Service transition), they need to remove the resolution from that book. You can configure Jira to do this automatically using a transition post function, which we’ll talk more about below.

Creating the best workflow

I’ve spent 10 years building workflows for many different types of teams.  Here are a few pieces of hard-learned advice.

Gather all of your stakeholders

Workflow is about scaling culture, and culture is about people. Whenever it comes time to build a process around a set of people, identify all of the stakeholders in that workflow. For example, if you’re trying to build a workflow that’ll be used by product management, software development, and support, make sure you have one representative from each role in the meeting.
As the person designing the workflow, spend time talking with each stakeholder about what’s important to them. Draw a draft workflow on the whiteboard, then walk through each case and gather their feedback.
Workflows are touchy because they govern how people work. Be patient, and your investment will pay off.

Keep your Jira workflow simple

Stakeholders often want to have statuses for each part of the workflow. That’s generally a good thing, but remember: each status adds more transitions and complexity. Aim for simple and scalable instead.
Whenever adding a new status to a workflow, make sure you have no other option. Let’s look at two examples.

As a Jira administrator, you owe it to yourself and your users to keep workflows simple.


//

Make every transition count

Jira has a number of options admins can take advantage of when setting up transitions:

Nail the workflow diagram

Once you’ve built the workflow, use the workflow designer to make sure the diagram is presentation quality. You’ll want to share the diagram with all your stakeholders for a final round of feedback. You should also enable the option in Jira to show where the current issue is in the workflow. All users have to do is click View Workflow.

Be build the change you seek

I said in the beginning that workflow is a fundamental aspect of succeeding with Jira. Listen to your customers, have empathy, and help them understand why what they’re doing might be inefficient – and how new ways of working can help them scale. When people work well together they have more fun and get more done. Who doesn’t want to be a part of that?
In my next article, we’ll see how Jira workflows help your team visualize data. I’ll show you five steps to configure your workflows so you can put all these ideas into practice. See you there!

Workflows are only the beginning. If you haven’t tried Jira yet, check out our product tour to see what else it can do for you and your team.


Ready for more Jira tips and tricks? Click below for more tips and best practices blogs.

Bring on the Jira tips!

Did you find this post helpful? Share it on your social network of choice and help your fellow Jira users create an awesome workflow!

Exit mobile version