Page tree

You are on the Xray Server documentation. If you are looking for Xray Cloud documentation, you can find it in this page

Skip to end of metadata
Go to start of metadata

After installing Xray, there are basically two steps you need to make or ensure before starting to use it.


Configure Requirements and Defects

In Jira's administration, in the Add-ons tab,  go to Issue Type Mapping and configure what issue types should be considered as "requirements" and "defects".




Learn more

Refer to the specific Issue Type Mapping page or take a look at the extensive Administration & Configuration if you want to fine-tune Xray or adapt it to your specific needs.


Enable Xray in your projects

You can enable Xray for your existing projects or create a new project with both standard and Xray issue types.

Enable testing in existing projects

For existing projects, in the project Administration page, go to Actions at the top right-hand side. You can either:

a) set your project as a Requirements project by choosing "Enable Xray Requirement Coverage", so the requirements are covered by tests; or

b) add Xray issue types (i.e., Test, Test Set, Test Execution, Test Plan) to the project.


Please note

Since the Issue Type Scheme being used by your project may also be used by other projects, in order to add Xray's Issue Types from the project settings page you must belong to a group allowed to do so in Xray settings. The allowed groups to add Xray Issue Types can be defined in this setting.




Create new projects from scratch with testing enabled

If, instead, you want to quickly create a new project and use it to manage everything (e.g., requirements, defects, tests), go to the Jira Administration page for Projects. In the creation dialog, choose "Xray Test Project".












  • No labels