ℹ️ Premium only
The Perdoo Jira cloud integration helps agile tech teams to save time and stay on top of their OKRs. Seamlessly integrate Results in Perdoo (Initiatives or Key Results) and pieces of work in Jira Cloud (eg Issues, Epics) to guarantee always-updated goals and anticipate challenges early on.
When creating or editing a Result in Perdoo, simply pick the Jira Epic, Story, Task or Bug that should update the value of the Result. Setup is lightning fast, and Perdoo will then directly link the metrics to update your OKRs and Initiatives in real-time.
In this article:
Set up the Jira integration
There are 2 steps to set up the Jira integration. In a couple of minutes, you'll have a Result in Perdoo linked to the work you're doing in Jira. Let's go!
Step 1. Enabling the Jira integration
Note: only Superadmins can enable the integration. But once enabled, all users can link Results to items in Jira.
To enable the Jira integration, go to Configure > Integrations tab > Jira.
Step 2. Linking a Result to a Jira issue
With the integration enabled, all users can now link Results' (Initiatives or Key Results) progress to work that's being tracked in Jira. Here's how:
⚠️ Once the Epic, Story, Task, or Bug is marked as "Done" in Jira, the Result's progress will be switched to its target value. Note that progress is driven only by the unit of work linked to the Result, not associated work (ie the Epic itself, not associated Issue completion).
The Jira integration runs automatically at 1AM CET each day.
* NOTE: To connect an issue, type the title or name of the issue, not the Jira key to search for it (in the example above,' Calendar app MVP' instead of 'PT-1').
Troubleshooting the Perdoo Jira integration
The status of your integration is always shown on the integration page, with a green 🟢 or red dot 🔴 . If your dot is showing red, there is a problem with the integration, likely caused by the connection to the Jira API. There are two potential reasons for this:
Jira is down: we'd recommend checking the Jira status page.
API token expired: for example, the user left the company and the account was removed from Jira.
Progress won't update based on the tasks you aligned to the Epic. The update is binary, so once the Epic is marked as done, it'll be 100% in Perdoo.
Also, if you change the status of your Jira issue back to In Progress, it will not revert the Result's status in Perdoo.
If neither of these scenarios helps to resolve the status of your Perdoo Jira integration, please contact our Support Team by emailing email@example.com or starting a chat at the bottom-right of your screen.