Workflows and statuses for the board
Statuses and transitions
Two concepts define a workflow:
Statuses: the steps in your team’s working process that describe the state of a piece of work.
Status categories: Jira lets you collect many statuses under a To do, In Progress, or Done category. These categories help you sort, filter, and report on your project work. For example, you might have a Backlog To do status and a Waiting for approval To do status. Or, you might have a Developing In Progress status and an In review In Progress status.
Transitions: This is how a piece of work can move between statuses. In order for a work item to move between two statuses, a transition must exist. A transition is a one-way link, so if a work item needs to move back and forth between two statuses, two transitions need to be created. The available workflow transitions are listed on the work item at the top-right corner in a dropdown.
Global transitions: Global transitions allow any status in a workflow to transition to a particular status. For example, you can drag a work item from the To do column directly to the Done column if the Done status has a global transition. More about global transitions
Workflows
Each business project workflow is composed of a set of statuses and transitions that your work item moves through during its lifecycle, and typically represents work processes within your organization. The path that your work items take is called a workflow. More about workflows
Different work types in your business project can have different workflows. For example, you may want to define a particular workflow or set of steps for a bug to pass through, compared to a task.
For team-managed projects
Only project admins can edit workflows for your team-managed project. View more about how to edit or create workflows for a team-managed project
For company-managed projects
Only Jira admins can edit workflows for your company-managed project. View more about how to edit or create workflows for a company-managed project
Statuses
The board is a visual way to view the status of your work items. The status for each work item can be determined by which column it’s in if your board is grouped by status. More about grouping on the board
If your work item is sitting in the To do column, then that's the status of the work item. You can also view the status by opening the work item, and viewing the status at the top right corner.
Your board’s statuses (in the columns) may differ depending on the project template that you’re using or how your admin has configured the workflow. So, depending on which template you’re using for your business project, your board’s statuses may look different from project to project.
You’ll only be able to view a done work items in the Done column for 14 days of it being moved there. After 14 days, the board will omit the work item. You’ll still be able to see it in the list, timeline, and calendar view.
Multiple workflows on your board
If your business project contains multiple work types with different workflows, you can easily select which workflow to view on your board.
To view a particular work type’s workflow, you can:
Select … More at the top right of the board view
Select Workflows
Choose which work type’s workflow you’d like to view.
You’ll only be able to view statuses and transitions associated with the selected workflow on the board
You can only create the type of work item with the workflow that’s selected
Rearrange the columns in your board
Only Jira and project admins can rearrange the columns in your business project’s board.
You can rearrange the order of your columns in your board by dragging them to your preferred order. For example, you may want to drag your in-progress column first, so you can easily view what’s in flight. If you change the order of the columns, the new order will only be visible to you.
Was this helpful?