What are Jira workflows?

All Jira projects contain work items that your team can view, work on, and transition through different stages — from creation to completion. The path that your work items take is called a workflow. Each Jira workflow is composed of a set of statuses and transitions that a work item moves through during its lifecycle, and typically represents processes within your organization.  

Company-managed project workflows

In company-managed projects, Jira uses workflow schemes to define the relationship between work types and workflows. Workflow schemes are associated with a project, and make it possible to use a different workflow for different combinations of project and work types. If you need to edit or create a more advanced workflow to match how your team or organization works, you can log in as a Jira administrator with global permission to access and create your workflow.

To keep things simple, use the default workflows that come with the project type you select in Jira. You can always modify or create new workflows later.

What you can do

Documentation

  • Edit existing workflows

  • Create new workflows

  • Configure existing workflows 

  • View workflow in company-managed projects

Working with workflows

  • Add a workflow scheme

  • Configure a workflow scheme

  • Manage workflow schemes

Configuring workflow schemes

  • Import and export workflows

  • Activate and deactivate workflows

Managing your workflows

  • Add custom events

  • Configure the initial status

  • Work in text mode

  • Configure workflow triggers

  • Use validators and custom fields

  • Use XML to create a workflow

  • Configure workflow properties

Advanced workflow configuration

Team-managed project workflows

Project admins can create, edit, or delete project workflows in team-managed projects. You can start off by using the default workflows that come with the template that you selected when you created a project. You can always modify or create new workflows later. You can have multiple workflows in each project through assigning workflow to specific work types.

What you can do

Documentation

  • Create new workflows

  • Edit workflows

Create and edit multiple workflows in team-managed projects

  • Learn about workflows, workflow statuses, and status categories

  • Learn about workflow transitions

  • View and edit a work type’s workflow

  • Save changes to a work type’s workflow

Manage how work flows in your team-managed project

  • Create or add a status in your work type’s workflow

  • Edit a status’s name or category in your work type’s workflow

  • Delete a status in your work type’s workflow

Create, edit and delete statuses in team-managed projects

  • Create, edit, and delete a transition

Manage work item transitions in team-managed projects

  • Rule to assign a work item to someone

  • Rule to check a work item's field

  • Rule to check whether a work item's been through a status

  • Rule to update a work item field

Available workflow rules in team-managed projects

  • Add a new rule to a transition

  • Edit or delete a transition rule

Add or remove workflow rules in team-managed projects

Still need help?

The Atlassian Community is here for you.