ℹ️ Available on Supreme.
Connect Jira Cloud to Perdoo so your engineering goals stay up to date on their own. Link a KPI, Key Result, or Initiative to a JQL query or a single Jira issue, such as an Epic or an Initiative, and track progress by issues or story points completed.
Once connected, Perdoo updates the goal for you as often as its sync frequency says. For more about progress drivers, see Progress drivers.
Connect Jira
Find Jira and click Enable.
Click Connect and allow access.
Click Finish.
Superadmins can also connect Jira in Configure > Integrations. After you connect it, click Settings (1) to choose whether your connection is private or shared with everyone.
Update a goal with Jira
Open the KPI, Key Result, or Initiative. To set it up while you add a goal, open Advanced options.
In the Details panel, click Progress driver.
Select Integration and choose Jira.
Select your Connection.
Choose a Source type: JQL Query or Individual issue.
Enter your JQL query, or select the project (optional) and the issue.
Choose how to Track progress by. See Ways to track progress.
Check the preview.
Click Save & Sync now.
Ways to track progress
With a JQL query
Track progress by Issue count, Percentage of issues completed, or Percentage of story points completed. With Issue count, the goal's value is the number of issues your query returns. For example, track the number of open bugs with a query for bugs that aren't done.
With an individual issue
The ways to track progress depend on the issue type:
Issue status: The goal is at 100% when the issue is Done. Works for all issue types.
Epic progress by issues completed: The share of the Epic's issues that are done.
Epic progress by story points completed: The share of the Epic's story points that are done.
Initiative progress by Epics completed: The share of the Initiative's Epics that are done.
Initiative progress by Epic issues completed: The share of all issues under the Initiative's Epics that are done.
Good to know
How often does Perdoo fetch the latest value?
As often as the goal's sync frequency says, for example daily or weekly. Every sync adds a progress update, even if the value hasn't changed. To update sooner, click Update on the goal.
What happens if the connection stops working?
You get an email, and the goal shows a red connection error. Reconnect Jira in Personal settings > Integrations.
Can others update a goal that uses my private connection?
Yes. Anyone who can update the goal can fetch the latest value, but only you can change the connection's settings.
What if I move a Jira issue back to In Progress?
The goal in Perdoo keeps its progress. Update it manually if needed.
Why does my Jira connection show as disconnected?
Usually because Jira is down, or because the API token expired, for example when the person who connected Jira left your company. Check the Jira status page, and reconnect Jira if needed.
Need help?
Start a live chat with our Support team by clicking the question mark at the left or right bottom of your screen.