Define workflows for company-managed spaces with schemes
10 min
By the end of this lesson, you’ll be able to:
- Create a workflow scheme
- Associate workflow schemes with work types
- Edit a workflow scheme
- Share workflows
Create a workflow scheme
In company-managed spaces, Jira admins associate work types with a workflow using a workflow scheme.
👉 For example: The Bug work type should use the Bug workflow, which has different transition screens. All other work types should use the simplified workflow.
Each space can only use one workflow scheme. You can and should reuse one workflow scheme for multiple spaces to simplify administration.
To create a workflow scheme:
- In the upper-right corner of Jira, select Settings (represented by a gear icon).
- Under Jira admin settings, select Work items.
- In the sidebar, under Workflows, select Workflow schemes.
- Select Add workflow scheme.
- Name your scheme and add a detailed description so Jira admins know when to use it.
- Select Add.
- To add another workflow to your scheme, select Add workflow. You can assign the workflow to work types while adding it.
- To assign a workflow to work types, select Assign.
- To remove a workflow from your scheme, select Remove.
Associate a workflow scheme with a space
To apply the workflow scheme, you need to associate it with one or multiple spaces. Only Jira admins can associate schemes with spaces.
When you first create a company-managed space, it will use the default workflow scheme for that space type. Jira admins can configure this scheme as needed.
You can also change which scheme a space uses after you create the space.
To associate a work type scheme with a space:
- In the sidebar, next to the space name, select More actions (represented by ···), then Space settings.
- In the space settings sidebar, select Workflows.
- Select Switch Scheme.
- Select your scheme, then select Associate.
If you edit your workflow scheme, you’ll need to update your board as well.
👇Watch this video to learn about configuring workflow schemes.
Let’s explore an example!
Bill, a company-managed space admin, wants to add the Criteria field to the screen users see when they close requests. He does not want to add the Criteria field to other work types in the space as it isn’t relevant.
Jayda, a Jira admin, wants to meet Bill’s requirements. But, she wants to configure it as simply as possible, so this change doesn’t create more schemes to maintain or impact other spaces.
To meet this requirement:
- Jayda can copy and modify the existing workflow to show the Criteria field when transitioning to Done. Then, she can update the space’s workflow scheme to apply her new workflow only to the Request work type. However, this will impact other spaces that use this workflow scheme, and it will add a new workflow for Jira admins to maintain.
- Jayda can add the Criteria field to the current transition screen in the workflow associated with every work type. For all work types except Request, Jayda can hide the Criteria field in the field configuration. However, this will impact other spaces that use that field configuration.
Jayda needs to consider the impact of both options and choose which one will meet Bill’s space needs while minimizing the impact on administration.