Managing your workflows
As a Jira administrator, you need to activate workflows before your teams can use them to streamline project work. To activate a workflow, include it in a workflow scheme and associate that workflow scheme with a project. You can also import and export workflows to share them across teams.
Before you begin. This page contains information for how to set up and configure classic Jira projects. Classic Jira projects have different features and capabilities than next-gen Jira projects.
If you're looking for information on setting up a next-gen project, check out the following documentation:
Activating a workflow
All workflows are inactive until you associate them with a workflow scheme, which can then be associated with a project. To activate a workflow:
- Select > Issues.
- Under WORKFLOWS, click Workflow schemes to see a list of active and inactive schemes.
- Create a workflow scheme or edit an active workflow scheme. Tip: click the Active or Inactive headings to expand and collapse the list of workflows.
Add your workflow to the scheme. See Configuring workflow schemes for more information.
Follow the steps in the Associating a workflow scheme with a project section below.
Associating a workflow scheme with a project
To finish activating your workflow, associate the workflow scheme it's in with a project. If an issue type is not defined in the project's issue type scheme, that specific workflow is not used.
- Choose Settings > Projects.
- Select the project you want to associate your workflow scheme to.
- Go to your project and click Project settings.
- Click Workflows. You'll see which workflow scheme the project currently uses.
Click Switch Scheme and select the relevant workflow scheme from the Scheme list.
Click Associate to begin the migration process. Each issue needs to have a valid status, so you may need to assign statuses to a select number of issues after you switch workflow schemes.
A Jira project must always be associated with a workflow scheme, since all issues must move through a workflow. To disassociate a custom workflow scheme from a project, simply associate that project to the default workflow scheme instead.
Importing a workflow
- Select > Issues.
- Select Import from Marketplace.
- Find the workflow you want and click Select.
- Map the steps of the workflow to your existing workflow statuses or create new statuses at this point. When you are finished, click Next to continue.
- Preview your changes and click Import.
Exporting a workflow
- Select > Issues.
- Under WORKFLOWS, select Workflows.
- Find the workflow you want to share and click View.
- Select Export > As Workflow and click Next to continue.
- Add any special configuration notes (for example, information about plugins that should be installed).
Click Export and select a download location. Ensure the location is publicly accessible.
Exporting a workflow to Atlassian Marketplace
- Create an account on Atlassian Marketplace.
- Log in to the Atlassian Marketplace and choose Manage Add-ons. See Step-by-step Paid-via-Atlassian Listing for more information.
- Click Create new add-on.
- Choose My add-on is not directly installable and make sure the add-on type is "not a plugin".
- Add information about where the workflow export can be accessed in the Binary URL section.
- When you fill out the submission form, be sure to note the following:
- The Summary field contains the information that will be displayed to users searching the Marketplace.
- The Category for your workflow must be Workflow Bundles to ensure that it's visible to other Jira application users.
- The Add-on Key, which becomes your application URL and identifies your application, must be unique.
You don't have to complete the form in one session. You can save your form and come back to it later. Once you accept the Atlassian Marketplace Vendor Agreement, the system submits your add-on for review by Atlassian's Developer Relations team.