What is the difference between step and status?

parulshah July 20, 2014

In JIRA workflow I came across two terms step and status. What is the difference between step and status?

3 answers

18 votes
Nic Brough -Adaptavist-
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
July 20, 2014

Step is a position in a workflow, status is what you want to show to the users when an issue is on that step.

There's a 1:1 relationship between them, which often confuses new admins and your next question is going to be "then why have both?" - the answer is that in the workflow, the step is the important thing, the status is just a label, but Jira does a lot more with status so there's a whole load of coding around status that makes it a lot more simple if the two are separate logical entities with a simple link.

Your users will only see the status, steps don't matter to them. I think of steps as a "skeleton" which you hang the rest of the workfow settings off.

parulshah July 20, 2014

thanks a lot for sharing this information

Deleted user July 20, 2014

Tahnks for your detailed answers.
I think status is more important tahn steps. Because we see statuses and search based on it's value and etc.

I have another question. Every new admin have some problem for naming diffrerent part of workflows because he/she need 3 names for each stage of it. 1. Step Name 2. Status Name 3. Transition Name.
Do you have any idea or suggestion for that?

Like karen vargas likes this
Nic Brough -Adaptavist-
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
July 20, 2014

Status is not "more important" than steps, they're different things. It is important to remember that your users generally won't see steps, only status. But nothing would work without steps, so they're still necessary.

For your second question, you're getting confused. Workflows have TWO important and very different components.

STEPS are an indication of where an issue is in the workflow. They are associated with a status, as we've already discussed. Two pieces of advice I'd give you about steps

1. Initially, try to name them the same as the status you intend to use them with. That will make it easier to see and understand. Even as an experienced admin, I find it useful to keep them at least similar

2. When choosing the name of a status, remember that it is a description of a point in a process flow. In English (I'm ashamed to say that I don't speak any other language), the sentence you should aim for is "<issue> is <status>". So I can say "issue is open", "issue is blocked", "issue is under reveiew"

TRANSITIONS are an action that moves an issue from one status to another. You should name them in a way that indicates an action. It's a verb rather than a descriptive word. You "close" issues, or "resolve" them, or "reopen" them, or, for more complex flows "put under review" or "give to a developer"

Like # people like this
Lisa Ruby September 2, 2016

This is an old post, but I wanted to thank Nic. I've been a user of JIRA on and off for years. Am now setting up my own installation and this was driving me a little batty. You've clarified it for me.  Lisa

0 votes
MattS
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
August 15, 2016

Steps are the name used by the underlying OS Workflow library. Status is a JIRA concept. The workflow designer is where the mapping is done. I agree with Nic that the step name and status name should match, or you will get confusingly named buttons in some places in JIRA

0 votes
Vishnukumar Vasudevan
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
July 20, 2014
Michael Barton March 7, 2018

This link is broken.

Nic Brough -Adaptavist-
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
March 7, 2018

It is from 4 years ago and out of date.  Search the docs for "configuring workflow"

Suggest an answer

Log in or Sign up to answer