Using Fields

You can classify your tests in order to make it easier to organize and search for them. 

Jira has many options to classify your issues using system fields or even create your own. Here some examples:

  • use labels to tag your Tests (or your Test Sets); if you start having many testers and your project grows, having a well-defined list of labels may help
  • use the priority field, so you can distinguish between tests
  • assign the Test to the proper component
  • Ask your Jira Administrator to create your own custom fields

Using Test Sets


Xray gives you a new Jira issue Type, named Test Set, that enables you to get tests grouped into a list.


A Test Set is a collection of Tests. It often contains detailed instructions or goals as well as information on the configuration to be used during testing.

Test Sets are simple, flat lists of Tests that you can use as a basis for creating Test Executions or Test Plans. Since the Tests are grouped in some logical way, such as grouping all Tests related with regression testing or security, or all Tests for a specific component or some high-level feature/business case, a Test can be part of different Test Sets. Test Sets can also be used as a dynamic way to cover requirements.


Examples of Test Sets:

You can create test set for: 

  • Group Tests by UI Component
  • Group Tests by Type (security, performance, integration, regression,  etc)
  • Group Tests by high-level features/business case


Teams with strong knowledge of Jira may like to use Test Sets to organize Tests, as it is similar to have an issue linked to other issues (tests).

Using Test Repository


Xray enables a new project area, that is available from your Project sidebar, the Test Repository. The Test Repository is a project-level Test organization feature that allows users to organize Tests hierarchically via folders. 


The Test Repository concept enables the hierarchical organization (tree-like organization) of Tests at the project level by allowing you to organize Tests in folders. 

The Test Repository concept is similar to the same way you would organize your documents and files in your computer.

It is not a new issue type!




You can use all options at the same time, taking advantage of the differences and features of each one. 

Learn more about the differences in the next module.