---
title: "Auto-KR"
canonical: "https://support.appfire.com/space/OFJ/603653251/Auto-KR"
format: markdown
---
> Macro (aura-html)

> ℹ️ This page is about **OKR for Jira Cloud**. Using** Data Center**? **[Click here](https://appfire.atlassian.net/wiki/spaces/OFJ/pages/603652538)**.

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.](media://86dd0dde-d9a0-443d-a6ca-1638863f11af)

#### **How to create an auto-KR**

1. When adding a KR to an existing objective, select the **Linked issues** option.
2. Click **Link issues** to establish connections between your Key Result (KR) and relevant Jira issues.
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](https://www.atlassian.com/blog/jira-software/jql-the-most-flexible-way-to-search-jira-14#:~:text=JQL%20stands%20for%20Jira%20Query,project%20managers%2C%20and%20business%20users.).

4. After configuring your linking preferences, confirm your choices by clicking **Link issues**.
5. 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.

6. 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](media://ab6b2ef9-1243-4d43-b677-c4cd037535ef)

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](media://11226841-cb2d-468a-b20a-999606a21b1f)

#### **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**.
2. You will be informed about what will happen after you change the KR type. Confirm the conversion by clicking **Convert**.
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**.
2. You will be informed about what will happen after you change the KR type. Confirm the conversion by clicking **Convert**.
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.