Jira Sync Overview

Try Shortcut with minimal disruption by syncing a Jira project to Shortcut and see how much easier and better it is to work in Shortcut!


What is Jira Sync?

  • The Jira Sync helps remove friction when new users currently using Jira are evaluating Shortcut. You can try Shortcut with minimal disruption to your existing Jira instance during your trial! It is an opportunity to work in Shortcut and update stakeholders on the status of your team’s work. 

What does Jira Sync do when it is turned on in a Shortcut Workspace?

  • New Stories created in the Shortcut workspace will be created as issues in the Jira project 
  • New issues created in the Jira project will be created in Shortcut.
  • Shortcut Story Workflow States updates with be reflected in Jira.
  • The following table shows what is and what is not synced upon and after a Story or Issue creation:

What is Synced?

What is not Synced?

  • Shortcut Issue creation <--> Jira Issue creation:
    • Story/Issue Title
    • Story/Issue Description
    • Story/Issue Requestor
    • Link to Shortcut Story in Jira Issue description/Link to Jira Issue on the Shortcut Story 
  • Shortcut Issue Update <--> Jira Issue Update:
    • Story/Issue Title
    • Story/Issue Description
  • Shortcut Issue Workflow State Update --> Jira Issue Status Update
  • After Story creation, any changes to Story metadata (excluding title and description) will not sync over in Jira.
  • The Workflow State status is not bidirectional.
    • Post-sync updates in Shortcut sync back to Jira however updates in Jira will not sync back to Shortcut at this time.


How do you set up Jira Sync?

Step 1: Import Jira Data


  • Please note that in the last step of the import process, you will be asked if you would like to turn on Jira Sync and select a Team that newly synced Stories will be assigned to in Shortcut. If not, simply complete the import process.



Step 2: Set Up Jira Sync

  • If you have already imported the data from Jira to Shortcut, skip step 1 and navigate to your Settings > Import/Sync page and select the "Set Up Jira Sync" option.



Step 3: Map the Data

  • When you select that setup option, the below modal will show where you can select the Jira Project you are hoping to sync with a Shortcut Workflow. 
    • Please note that only one Sync can be active at a time per Workspace 

  • If you have already imported Jira data into Shortcut, when you turn on the Jira Sync you will be asked to choose a Shortcut Team (you can also select no Team) to assign stories to upon creation.


Visit our Training Hub to review the Transitioning from Jira Best Practices Guide and the Transitioning from Jira Setup Guide for more details.


After the Sync:

  • The UI shows the live sync connection.
  • The option to disable sync is provided.
    • Please note that if you would like to sync another Jira project, you will have to remove the Jira sync that is active.


  • Shortcut Stories will show the Shortcut <> Jira connection:
    • On the Story Card after Story creation:

    • In the Story modal after Story creation:


    • In the Story modal during Story Creation:


Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request