Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

There are two ways to link your issues to the KRs.

Connect issue from Jira issue view

Open an issue you’d like to connect
Panel
panelIconIdatlassian-info
panelIcon:info:
panelIconText:info:
bgColor#F4F5F7

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

This guide explains how to link your Jira issues to Objectives and Key Results. This connection helps visualize how specific tasks in Jira contribute to achieving your strategic goals outlined in OKRs.

Remember:

  • You can use linked issues to visualize and track work contributing to achieving your Key Results.

  • Linked issues do not directly impact the Key Result progress percentage.

Contents

Table of Contents
minLevel3
maxLevel6
include
outlinefalse
indent
exclude
typelist
printablefalse
separatorbrackets
class

Linking from Jira Issue View

  1. Open the issue you want to link.

  2. Click the OKRs panel on the right

panel
  1. -hand side of your screen.

Image Removed

Select the objective to which your KR belongs to.

Image Removed
  1. image-20240214-160951.pngImage Added
  2. Click Connect to OKR.

    image-20240214-161004.pngImage Added
  3. Select the KR you want to link the issue to from the

list of this objective’s KRs.Confirm by clicking “Connect”. Your issue is now connected and
  1. dropdown menu.

    image-20240214-161220.pngImage Added
  2. Click Connect.

Now, your issue will appear on the

kanban

Kanban board

on the key result’s page

associated with the chosen KR.

Connect issue from the KR page

Linking from Key Result Page

  1. Open the

key result
  1. Key Result page

to which
  1. you want to

connect
  1. link an issue to.

  2. Scroll down to the

“Connected issues”
  1. Linked issues section.

  2. Click

the “Connect existing issues” button
  1. Edit linked issues.

Image Removed
  1. image-20240214-162813.pngImage Added
  2. Either:

    • Select issues

from a list or type in a JQL query to search for the issues you want to link. If you don’t know how to for a JQL query, click here.
Image Removed
    • manually by using the quick search and filters.

    • Set up automation rules to automatically link related issues to OKR when certain conditions are met. For example, using this feature, you can link issues that belong to a specific Epic, and when you add more issues to the Epic, those will be automatically linked to the KR as well.

      Screen Shot 2024-02-14 at 19.52.59.pngImage Added
    • Type a JQL query to find specific issues. To learn more about JQL, click here.

  1. All selected issues will be connected to the key result after you click the

“Connect issues” button. Number appearing on the button is the number of selected issues.
Image Removed
  1. Save button.

You should now see the issues on the

kanban

Kanban board.

Both specific issue linking and automated linking are available for the same KR. This is applicable to KRs with both automatic and manual progress tracking.

Creating New Issues Linked to the KR

You can also create new issues while

being

on the KR page. Issues

you’ll create

created this way will be connected to the KR from the

beginning

outset.

Create new issues connected to the KR
  1. Open the

key result page
  1. Key Result page you want to create and link an issue to.

  2. Scroll down to the

Initiatives section
  1. Linked issues section.

  2. Click Edit linked issues.

  3. Click the

“Create issue” button
  1. Create issue button at the top-right of the screen. You will see a standard Jira window for creating issues.

  2. Fill in the relevant fields

and click on the “Create” button.You’ve created a connected issue. It should be visible both in Jira and on your kanban board in a few seconds
  1. to create the issue. You can import issues as well. For more information on import, click here.

    Screen Shot 2024-02-14 at 20.13.54.pngImage Added
  2. Click Create.

  3. Click Save to complete the process.

Editing Linked Issues

On the KR Overview page, navigate to the Linked issues section, and you will find all the issues linked to the KR. You can edit them by clicking the Edit linked issues button.

Screen Shot 2024-01-14 at 20.22.56.pngImage Added

In Edit mode, you can search for issues using filters or JQL and create new links, or you can directly create new issues to link directly on this screen. To remove a link, navigate to the tab where the link was initially created. Click the number next to the tab, and then select the checkbox beside the issue you wish to unlink.

Screen Shot 2024-02-29 at 19.12.43.pngImage Added
image-20240229-161923.pngImage Added

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).