21 October 2024 - The integration now automatically detects when new people join a project in Jira and shows them on the Project Planner in Runn.
Please fill out this Request Form if you'd like to get access.
Why enable the Jira Integration with Runn?
Runn’s Jira integration makes it easy to bring your people from Jira projects into Runn for easy scheduling.
Saving time from manually adding Project Teams
With Runn's Jira integration, you can easily import project teams on chosen Jira projects in Runn, saving time from manually adding the project team members one by one.
See when new people are assigned issues in Jira
The integration will automatically detect when new people are assigned issues in your linked Jira projects on an ongoing basis and has shortcuts to quickly add these people to your projects in Runn.
Easy access to Jira from Runn
You can open linked Jira projects directly from Runn, so you can easily check the task completion progress in Jira and adjust the schedule accordingly.
This integration currently supports importing of project teams on a project-by-project basis in this beta version.
Please note that linking projects in bulk is not available at the moment. We are planning to support this function in a future update.
How to turn on Jira Integration?
Please refer to the Initial Setup instructions to set up the integration.
Linking a new Project in Runn with Jira
If the Jira project you want to link is added after the
From the Project Planner, click on the New button and select Project
Enter the Project Name (You can choose to enter the same name for the project in Runn or have a variation. The name of the project won’t change in Jira.)
You’ll now see an External Project field below the Project Name. The External Project field contains a list of all your active Jira projects.
Choose the Jira project you want to link to.
Fill out all the other fields and click Next
Troubleshooting
I don't see my latest project(s) from the External Project List. What should I do?
If you can see your Jira projects but your latest project(s) is/are not in the list then you can trigger a manual sync, by going to Setting > Integrations and choosing the “Options” menu in the top right corner, then selecting “Sync Now”.
I don't see any projects listed in the “External Project” list. What should I do?
If you don’t see any projects listed in the “External Project” list then your initial sync hasn’t been completed. Go to the Settings > Integrations screen to check for progress.
Importing people from your Jira project
After completing Step 1 to 5 above, you will be taken to a new Import people screen
You can now choose which of the people that are currently assigned to issues on the Jira project you want to schedule inside Runn. You can either select all of them or just specific people.
Runn will prompt you to link these people to an existing person in Runn (if the email addresses are the same) or create a new person.
You’ll also need to choose a role for every person on your project team. Once you’re done, choose Add to Project
You’ll now be taken back to the Project Planner with your chosen team, ready for scheduling.
Runn will detect any new people that are assigned issues in Jira and display these in the "Detected in Jira" section at the bottom of the project. Next to each person is an option to "Activate" them which will add them to the project team
At the top of the "Detected in Jira" section you'll also see an option to "Activate all" the people not yet on the project.
Troubleshooting
Why don't I see everyone's email address on the list?
When importing people you may notice that not every person’s email address is listed. This is due to a privacy setting which is controlled in Jira by each person.
If the person’s email address is not entered you can do this manually in Runn. You only need to enter an email address if you want to invite the person to have access to your Runn team (you can still schedule a person without their email address being entered)
My project team in Jira has been updated. Why don't I see the latest team members in Runn?
Runn will sync your project team (shown in step 6 above) throughout the day. If you're missing people you can go into the Integration Settings screen and select the option to "Sync now". The sync should then happen within 15 minutes.
Runn will only show people that have at least one issue assigned to them in the linked Jira project.
Linking an existing Runn project
Any existing project in Runn can be linked to a Jira project too. Runn will detect any additional people that are working on the project that you haven't already added as project members.
From the Project Planner, click on the 3-dot icon next to the Project Name
Click Edit Details
You’ll now see an External Project field below the Project Name. The External Project field contains a list of all your active Jira projects.
Choose the Jira project you want to link to.
Click Save
Opening your Jira project from Runn
Once the Jira link is established, there are 2 shortcuts in Runn to open your Jira projects
From Project Planner
Choose the project shortcut menu next to your project on the Scheduling screen in Runn and choose “Open in Jira”
From Project Dashboard
From your project’s dashboard in Runn, you’ll now see a Open in Jira link which will open a new browser tab and take you to the specific project inside Jira.
View and Search for Projects linked with Jira
From your Manage > Projects screen, you’ll see a Jira icon shown next to any project that you have linked.
Tips
If you enter “Jira” into the project search bar, you can quickly filter your active project list to just those projects you have already linked to Jira.
Disconnecting the integration
If you no longer need to link your projects to Jira
Go to the Settings > Integrations screen
Click the toggle button on the far left of the Jira panel to disable the syncing process.
Click on the options icon in the top right of the Jira panel and select Disconnect Jira
Frequently Asked Questions
How often does Runn sync the project list with Jira?
The sync will be performed automatically at least every 6 hours.
Can I automatically import people that are new to my project in Jira?
New people will be automatically shown at the bottom of your linked project in the "Detected in Jira" section of your project on The Planner. You can then quickly add them as project members either individually via the shortcut option next to each person or in bulk using the shortcut option at the top of the "Detected in Jira" section.
How do I link my Jira projects in bulk?
We only support linking projects one at a time at the moment. We’re planning to support this in a future update.
How can I have my time logged against Jira issues synced with Runn?
We don’t support this at the moment. We’re keen to hear how you’re logging time for Jira projects at the moment so we can consider this.
Are you planning to integrate with other project management tools?
Yes! We’re actively working on this. Please let us know what tools you’d like to see integrated.