How To Configure Xray In Jira

If your team utilizes Jira for organizing software development projects, chances are you are familiar with Xray. This robust test management solution seamlessly integrates with Jira, simplifying the task of monitoring testing progress and identifying issues before they affect your project. However, what is the process for setting up Xray in Jira? Here, we will provide a detailed, step-by-step guide.

Step 1: Install the Xray App

Before you can start using Xray in Jira, you’ll need to install the Xray app. You can do this by navigating to the Atlassian marketplace and searching for the Xray Test Management app. Click on the ‘Free trial’ button to install the app in your Jira instance.

Step 2: Configure Project Settings

After you’ve installed the Xray app, you’ll need to configure your project settings. Start by navigating to your project in Jira, then click on the ‘Project settings’ link in the sidebar.

In the project settings, look for the ‘Xray Test Management’ section. Here, you’ll be able to configure the app to meet your team’s specific needs. For example, you can choose which issue types should be treated as tests, set up test environments, and more.

Step 3: Create a Test Plan

Now that Xray is set up in your project, you can create a test plan. Navigate to the ‘Tests’ menu in the top bar and click on ‘Test Plan’.

Use the form that appears to create your test plan. You can specify the name of the test plan, the objective, the planned start and end dates, and more. Click ‘Create’ when you’re finished.

Step 4: Add Tests to Your Plan

After creating your test plan, it’s time to add tests. Go to your test plan and click on the ‘Add Tests’ button. You can choose to add existing tests from your project, or create new tests directly from the test plan.

Step 5: Execute Your Tests

When your test plan is ready, you can start executing your tests. Simply go to your test plan, find the test you want to execute, and click on the ‘Execute’ button.

Xray will keep track of the results of your tests, giving you a real-time overview of your testing progress. You can view the results of your tests at any time by going to your test plan and clicking on the ‘Results’ tab.


That’s all there is to setting up Xray in Jira! By following these steps, you can get this powerful test management tool up and running in your project in no time. And once it’s set up, you’ll be able to track your testing progress in real-time, helping you catch issues before they impact your project. Happy testing!