Auto-KR

Auto-KR

This page is about OKR for Jira Cloud. Using Data Center? Click here.

In the auto-KR mode, the progress of the Key Result is calculated based on the linked issues. As your teams work toward their OKRs and update the statuses of the associated issues, the progress of the KR automatically changes.

KRs in the auto mode require minimal user intervention to maintain accurate tracking. Auto KRs work particularly well for Jira tasks like bugs, new features, and test cases.

Note the “sync” icon for the auto-KR:

Auto-KR.

How to create an auto-KR

  1. When adding a KR to an existing objective, select the Linked issues option.

    image-20240326-181927.png
  2. Click Link issues to establish connections between your Key Result (KR) and relevant Jira issues.

    Screenshot 2024-03-26 at 21.21.29.png
  3. You have two options:
    Select manually – Search for an issue name or apply filters to narrow down available issues based on criteria such as project, issue type, or other relevant parameters. Utilize Jira Query Language (JQL) for more granular and specific searches.
    Automated linking – Here, you can set up automation rules to link related issues to OKR automatically when certain conditions are met. Define filters based on Project, Issue Type, Parent, and more. Alternatively, use JQL for automated linking based on your criteria.
    Create issues seamlessly within the app by clicking the Create issue button.

If you’re not familiar with JQL, check out the Atlassian documentation.

  1. After configuring your linking preferences, confirm your choices by clicking Link issues.

  2. The number of linked issues will appear in the Linked issues section. Click on the number to see all the linked issues and further edit them depending on your needs.

image-20240326-182305.png

 

 

image-20240213-175307.png
When you click the linked issue number, you’ll be redirected to this screen, where you can manage all the linked issues.
  1. Don’t forget to save your configuration.

How to use auto-KRs

All Auto KRs are marked with a "sync" symbol, visible on the OKR Overview and individual pages.

image-20240213-180615.png
OKR Overview: KR-2 is a typical key result with manual progress tracking. KR-13 is a key result that is automatically tracked.

In the Status changes section of the Auto KR, you will see both your own status changes and automatic progress updates made by the OKRobot bot.

image-20240213-184825.png

In the Activity tab, you'll find all activities related to KR's issues. A new activity will be added whenever an issue is connected, disconnected, or its status is changed.

Screen Shot 2024-02-13 at 21.51.06.png

In the Linked issues section, you will find all the issues linked to the KR, and you have the option to edit them. You'll also see when the KR was last synced with Jira and can manually trigger a refresh (in case you made changes and want to see the results immediately).

image-20240213-185709.png

How to convert auto-KRs into manual KRs

  1. Click the three-dots menu next to the Update button and select Convert to manual KR.

    image-20240213-192508.png
  2. You will be informed about what will happen after you change the KR type. Confirm the conversion by clicking Convert.

    Screen Shot 2024-02-13 at 22.25.39.png
  3. Your KR is now manual, which means:

    • Connected issues will remain connected but won’t have an impact on the progress.

    • There won’t be any automatic progress updates.

    • Your start/desired value won’t change unless you change it manually.

How to convert manual KRs into auto-KRs

  1. Click the three-dots menu next to the Update button and select Convert to auto KR.

    image-20240213-192911.png
  2. You will be informed about what will happen after you change the KR type. Confirm the conversion by clicking Convert.

    Screen Shot 2024-02-13 at 22.29.39.png
  3. Your KR is now automatic, which means:

    • Progress is calculated based on connected issues, along with the start and desired values.

    • Progress updates occur automatically following any status change in connected issues (synced every 5 minutes; manually trigger refresh by clicking Trigger refresh in the Linked issues menu).

    • If issues are linked and if you have used JQL to link them, they are integrated into the JQL used for syncing matching issues. Modify the query to cover additional issues by clicking Edit linked issues button in the Linked issues section.

    • If you didn’t have any linked issues, you need to link issues to see any progress. You can do that by clicking Edit linked issues button in the Linked issues section.

Need support? Create a request with our support team.

Copyright © 2005 - 2026 Appfire | All rights reserved.