• Products
  • Documentation
  • Resources

Import and export issue workflows

For security reasons, only site admins can export workflows from Jira.

Export a company-managed workflow as a workflow

If you wish to share your Jira Workflow with another instance of Jira or upload it to the Atlassian Marketplace, you first need to download it. Follow this procedure.

To export a workflow for use on your Jira Data Center instance:

  1. Select > Issues.

  2. Click Workflows.

  3. Find the relevant workflow and click View.

  4. Click Export > As Workflow.

  5. Select Next.

  6. Read the special instructions, then select Export.

  7. Save the file to your local machine.

Upload your workflow to the Atlassian Marketplace

To share your workflow with other Jira users, upload it to the Atlassian Marketplace.

  1. Create an account on Atlassian Marketplace.

  2. Log in to the Atlassian Marketplace.

  3. Select your user profile > Manage partner account.

  4. Select Create app.

  5. Select Upload your app artifact (.jar, .obr, or .jwb) and upload your workflow in .jwb format, then fill the required fields and select Next: Make Public.

    1. The App key must be unique. This is something that uniquely identifies your application and will become the application URL.

    2. In case you are not interested in sharing the workflow with Jira Data Center, make sure to remove that option after selecting Jira on the Compatible application field.

  6. In the Get started step, fill in the required fields and select Next.

  7. In the About app step, fill in the required fields and select Next.

    1. Set the Categories as Shared workflows and Workflow.

  8. In the Page design step, choose a layout and select Next.

  9. In the Versions step, fill in the required fields. For the License, select Commercial - no charge, then select Next.

  10. In the Final steps step, agree to the Atlassian Marketplace Publisher agreement and select Submit.

Your app will now be up for review by Atlassian’s Developer Relations team.

Import a company-managed workflow from the Atlassian Marketplace

Other Jira users across the world have created a breadth of workflows they find useful in their company-managed Jira projects. You can import these workflows to try them out on your Jira site.

In Jira Cloud, you can't import workflows from anywhere other than the Atlassian Marketplace.

To import a workflow from the Atlassian Marketplace:

  1. Select > Issues.

  2. Click Workflows > Add workflowImport from Marketplace. You'll see available workflows, ordered by the number of downloads.

  3. Find the workflow you want and click Select.

  4. You can keep using the default workflow name or choose a new name and click Next.

  5. Map the steps of the imported workflow to your existing workflow statuses or create new statuses. When you're finished, click Next.

  6. Review the summary of the import details and click Import.

Export a company-managed workflow to a Data Center instance as XML

You can export any of your Jira company-managed workflows to use in your Jira Data Center or Data Center instances.

To export a workflow for use on your Jira Data Center instance:

  1. Select > Issues.

  2. Click Workflows.

  3. Find the relevant workflow and click View.

  4. Click Export > As XML.

  5. Save the file to your local machine.

After exporting your workflow to XML, you can follow our Data Center documentation to import the workflow self-hosted Jira products. Learn more about importing an XML workflow into a Jira Data Center instance.

 

Additional Help