Meet the new BigPicture navigation
A faster, smarter, and more intuitive way to work is here. We’ve redesigned BigPicture navigation to give you a smoother experience and better access to what matters most.
→ Discover what’s new, explore key improvements, and review feature name updates on the New navigation page.
→ The rollout will happen gradually, and the previous navigation will be retired in September 2026.
Link OKR to box
Link OKR to box (old navigation)
OKRs in the OKR module are only shown if they are linked to the box you are viewing.
Automatically link an existing OKR to a box
OKRs are automatically linked to the box when you:
link a Jira work item that is within the scope of the current box. In such a case, the Key Result (KR) that is linked to the work item from the current box will also appear in the OKR module, even if that Key Result belongs to a different box.
create an Objective/Key Result in the OKR module. The newly created OKRs appear in the current box and are visible on the Overview, Hierarchy, and Progress Dashboard pages.
import OKRs from another source.
Manually link an existing OKR to a box
The OKRs you create in the OKR module are global, which means you can link them to any other box in the box hierarchy.
Note that you cannot link individual KRs to a box, as they exist only with their respective Objectives. Once you select a Key Result you want to link, the parent Objective will also be selected.
In the box configuration
You can add OKRs to a box on the box scope definition page. And then, use a structure builder to arrange those OKRs into a hierarchy.
Define the OKRs to link. Go to box configuration > Tasks > box Scope definition page > OKR linked work section.
The Direct links only option lets you select individual Strategic themes/Objectives added to BigPicture. If any of those Strategic Themes or Objectives have Key Results, they will also be added to the box.
The All child items option lets you select individual Key Results. Since KRs cannot exist without their parent, the Strategic themes/Objectives to which they belong will also be added to the box.
Click Save.
Build a structure. Go to box configuration > Tasks > Task structure > select Objective & Key Result structure builder.
Click Save.
Go to the Gantt or Scope module. Your OKRs are now displayed in the task list. If any of the OKRs you have defined in the box scope are linked to Jira work items, they will also be displayed and nested under their respective Key Result.
In the OKR module
You can add an existing OKR to your current box directly in the OKR module.
Box with no OKRs
By default, no OKRs are linked to the box. If you land in a box where no OKRs were ever created or manually linked:
On the splash screen, click the Connect existing OKRs button to add OKRs to the scope of a box.
A screen with the available OKRs appears. Check the OKRs from the list you want to add to a box.
Click Connect to finish the process.
Box with OKRs
If someone has already created OKRs or linked work items from that box to some KRs, you can manually add more OKRs to it.
On the Overview page, click the Link to box button.
A screen with the available OKRs appears. Check the OKRs from the list you want to add to a box.
Click Save to finish the process.
Unlink OKRs from a box
In the box configuration
Go to box configuration > Tasks > box Scope definition page > OKR linked work section.
In the OKR linked work section, click X on the OKR to remove it from the list.
Click Save.
In the OKR module
Unlinking OKRs from a current box does not affect their progress (unless you unlink work items from the auto-KR or convert it to a manual KR).
Unlinking an OKR is not the same as deleting it. If you unlink an OKR, you can link it again to the current or another box.
If there is an OKR in your box that is no longer relevant to your current work, you can hide it. Note that you can unlink only:
OKRs that were created directly in the box
OKRs that were linked manually
KRs that are not linked to any work items (unlink the work items or convert the auto-KR to a manual KR to unlink it from the box)
To unlink an OKR from a box:
On the Overview page, click the Link to box button.
A screen with the available OKRs appears. Uncheck the OKRs from the list you want to remove from the box.
Click Save to finish the process.
Link OKR to box (new navigation)
OKRs in the OKR module are only shown if they are linked to the box you are viewing.
Automatically link an existing OKR to a box
OKRs are automatically linked to the box when you:
link a Jira work item that is within the scope of the current box. In such a case, the Key Result (KR) that is linked to the work item from the current box will also appear in the OKR module, even if that Key Result belongs to a different box.
create an Objective/Key Result in the OKR module. The newly created OKRs appear in the current box and are visible on the Overview, Hierarchy, and Progress Dashboard pages.
import OKRs from another source.
Manually link an existing OKR to a box
The OKRs you create in the OKR module are global, which means you can link them to any other box in the box hierarchy.
Note that you cannot link individual KRs to a box, as they exist only with their respective Objectives. Once you select a Key Result you want to link, the parent Objective will also be selected.
In the box configuration
You can add OKRs to a box on the Add work items from Jira page. And then, use a structure builder to arrange those OKRs into a hierarchy.
Define the OKRs to link. Go to box configuration > Tasks > box Add work items from Jira page > OKR linked work section.
The Direct links only option lets you select individual Strategic themes/Objectives added to BigPicture. If any of those Strategic Themes or Objectives have Key Results, they will also be added to the box.
The All child items option lets you select individual Key Results. Since KRs cannot exist without their parent, the Strategic themes/Objectives to which they belong will also be added to the box.
Click Save.
Build a structure. Go to box configuration > Tasks > Task structure > select Objective & Key Result structure builder.
Click Save.
Go to the Gantt or Scope module. Your OKRs are now displayed in the task list. If any of the OKRs you have defined in the box scope are linked to Jira work items, they will also be displayed and nested under their respective Key Result.
In the OKR module
You can add an existing OKR to your current box directly in the OKR module.
Box with no OKRs
By default, no OKRs are linked to the box. If you land in a box where no OKRs were ever created or manually linked:
On the splash screen, click the Connect existing OKRs button to add OKRs to the scope of a box.
A screen with the available OKRs appears. Check the OKRs from the list you want to add to a box.
Click Connect to finish the process.
Box with OKRs
If someone has already created OKRs or linked work items from that box to some KRs, you can manually add more OKRs to it.
On the Overview page, click the Link to box button.
A screen with the available OKRs appears. Check the OKRs from the list you want to add to a box.
Click Save to finish the process.
Unlink OKRs from a box
In the box configuration
Go to box configuration > Tasks > box Add work items from Jira page > OKR linked work section.
In the OKR linked work section, click X on the OKR to remove it from the list.
Click Save.
In the OKR module
Unlinking OKRs from a current box does not affect their progress (unless you unlink work items from the auto-KR or convert it to a manual KR).
Unlinking an OKR is not the same as deleting it. If you unlink an OKR, you can link it again to the current or another box.
If there is an OKR in your box that is no longer relevant to your current work, you can hide it. Note that you can unlink only:
OKRs that were created directly in the box
OKRs that were linked manually
KRs that are not linked to any work items (unlink the work items or convert the auto-KR to a manual KR to unlink it from the box)
To unlink an OKR from a box:
On the Overview page, click the Link to box button.
A screen with the available OKRs appears. Uncheck the OKRs from the list you want to remove from the box.
Click Save to finish the process.