Importing data from Jira to Shortcut

Bringing the work your team has completed elsewhere has never been easier. With our Jira importer, your progress, history, insights, and all the wins you’ve made together elsewhere can now be imported directly into Shortcut. 

We’ll work to improve every facet of this import process using your direct feedback and insights along the way. Ready to get started?

Before you begin

Preparing for the import will ensure a smooth process from start to finish. Here are some key things you'll need to complete this process:

  • Admin (or Owner) status on Shortcut (Members cannot see the Import page in Shortcut)
  • Admin status on Jira (used to generate auth keys and tokens)
  • Confirmation that your data lives on Jira Cloud - we are unable to support imports from Jira Server at this time 

And, while certainly not mandatory, it could be helpful to consider doing this optional step as well:

  • Create any new Workflow States you might need to match current Workflow States in Jira to save time

1: Import Setup 2: Map a Workflow 3: Map Story Types 4: Map Workflow States 5: Map Users 6: Finish Import
    1. Select Jira from the import options to head to the next page. 
    2. Enter in the email you use to log in to Jira. (This must match your Jira email that has Admin status)
    3. Enter your generated authorization token. This can be found in Jira: Account Settings -> Security -> Create and Manage API tokens
    4. Enter in your API hostname. Example: (make sure to remove the https:// if you're copying this link over)
    5. Enter in your Project Key. Learn about the Project Key and where to find it here.



After the Import

What's next? You can now directly check out the contents of the Project housing all of your Jira data, or invite any users that weren't mapped during the process. 

Your imported data should be easy to identify around Shortcut by their new Labels. Head to the Labels page and view the newly created Labels that accompany the Jira data. You can also use our bulk Story editor to make large-scale changes on Labled Stories. 

Need to roll back this import and try again? That's easy, too! Head back to the Import screen within Shortcut and navigate to the Past Imports thread. From here, you can delete previous imports

Need to Run a Second Import?

Running a second import will create new stories for Jira tickets that have already imported, resulting in duplicates.

Another point.

There are a few of options to get those additional tickets into Shortcut as Stories:

  1. Create a new Jira project, move the new tickets there, then import just that project (this is the easiest option, but note that these won’t be in the proper project in Jira, if that matters.)
  2. Rollback the prior import completely and re-import to get the new stories (Note that this will cause any changes done on the Stories that were part of the prior import to be lost)
  3. Do a new full import into a different project, then move the net new stories to the correct project, followed by a deletion of the remaining duplicates - very manual or would require scripting!
  4. Create new Stories manually in Shortcut for the new tickets in Jira