You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

Requirements can be covered by Tests, and are the expected result for the system. 

Defects are identified during Tests Executions, and represent a condition in the system that does not meet the requirement or end-user expectations. 

In Jira, Requirements and Defects are going to be created as issues inside a project.


Basic terms


Decide which issue types to use


Discuss with your team which issue types can be considered as Requirements & Defects. If none of the existing issues types is suitable, you can always create new ones!

Nevertheless, remember that can re-use existing issue types and you don't need to create extra ones!

What issues type can be used as Requirements?

Basically any issue type can be mapped as a requirement in JIRA, but the most common ones are: 




What issue types can be used as Defects?

As within requirements, any issue type can be considered a defect. 

By just using default JIRA issue types, the "Bug" is the strongest candidate to be mapped as a Defect. 

Map Requirements & Defects


  1. In Jira's administration, in the Manage Apps tab,  go to Issue Type Mapping and drag-and-drop the issue types that should be considered "requirements" and "defects".

2. Click "Save"



Confirm Sub-Requirements behaviour

By default Xray will have the following settings enabled: 


This means that a requirement can be associated with sub-requirements, resulting in a hierarchy of requirement issues. With these options enabled, you will have this behaviour by just using the relation: 

  • Issue > Sub-Task - For example using issue types like "Requirement" & "Sub-Requirements"
  • Epic > Story 


In order to have "Sub-Tasks / Links" working correctly, you need to have the Sub-Task requirement issue types also be associated with "Requirements" in the Issue Type Mapping section. 


If you decide to disable these options, you can set the sub-requirement behaviour using the JIRA linking mechanism. You just need to select which "Issue Link Type" to use and the correct "Direction. 



A Jira re-index operation is recommended when there are changes to Issue Type Mappings.
















  • No labels