Skip to main content

Associate Defects with OKRs

Link Agility defects with Key Results directly from the OKR user interface to track how quality improvements contribute to strategic objectives.

Who Associates Defects with OKRs​

Defect association supports quality-focused objectives:

  • Quality Analysts link defects to key results focused on quality metrics, customer satisfaction scores, or stability targets.
  • Product Owners associate defects with key results to show how technical debt reduction and bug fixes contribute to product objectives.
  • Team Members connect defects to team quality goals during sprint execution to demonstrate how quality work advances measurable objectives.
  • Technical Leads link architecture or performance defects to key results focused on reliability, scalability, or technical excellence.

Permission Requirement​

To associate defects with key results: Users need Agility Pro or Premium license with view access to defects. Only key results from publicly visible objectives can be associated.

To view defect associations: All users with access to the key result can see associated defects in the Associated Assets section.

To remove defect associations: Users with edit access to the key result can remove any defect association.

Associate Defects with Key Results​

  1. Log in to Agility and click the hamburger menu Hamburger icon > OKRs.
  2. From the OKRs page, select an Objective and click on Key Result.
  3. Click Show More. In the Associated Assets section, click +Add.
  4. From the drop-down, select Defect.
  5. In the search bar, enter the Defect ID or Title.
  6. Select the Defect and click Assign.

The defect is assigned to the selected objective's key result.

Troubleshooting​

Why can't I find the defect I want to associate?

Verify you have view access to the defect and that it exists in the system. Use the defect ID for more precise searches. If the defect is in a project you don't have access to, you cannot associate it.

Why don't I see the defect option in the dropdown?

The OKR feature toggle must be enabled in your Agility instance. Contact your administrator to enable OKR functionality and verify you have Agility Pro or Premium license.

Can I associate multiple defects with one key result?

Yes. Key results support multiple defect associations, which is useful when tracking quality objectives that require fixing several related issues. Add each defect separately using the +Add button.

Should I associate all defects with OKRs?

No. Associate defects only when they directly contribute to strategic key results, such as quality metrics, performance targets, or customer satisfaction goals. Not all bug fixes need OKR associations.