3 tips to manage your tests in JIRA using Xray

3 tips to manage your tests in JIRA using Xray

Do you manage your tests in JIRA with Xray? Would you like to improve the user experience for your testers? If so, these three tips are for you!

Tip 1: Insert images in a step of your test

At Valiantys, we have found that there is a reoccurring need to add images into the steps for testing. The good news is that with Xray, this is both possible and easy! Here’s how:

  1. Create a Test request.
  2. Once this is created, click on the field where you would like to insert your image.
  3. Hit the tab button on your keyboard – a grey button should appear.
  4. Click on the grey button and insert your image.


Tip 2: Structure the tests

When we work with tests, we use several specific terms: Test case, test plan, test set, etc. How should we organise the hierarchy these concepts to facilitate the navigation in JIRA?

For this tip, you’ll need to install Structure – The Issue Organizer (version 3.4 or higher). You’ll also need the add-on Xray – Test Management for JIRA, version 2.1 or higher.

(warning) If you install Structure after Xray, remember to restart your JIRA for this tip to work!

Create a new Structure

  1. In the navigation bar, choose Create Structure.
  2. Select Empty Structure.
  3. Enter the name of the Structure.
  4. Define the group who will have access to this structure.


Personalise the Structure

  1. Click on Automation > Extend and then Xray Extender.
  2. Select Extend Levels > All levels.
  3. Click Add > Search & Add.


You can now drag and drop your tests from the column on the right to the column on the left.

If you move a test set, all associated tests will automatically be moved at the same time.


Once the Structure configuration is complete, it will allow you to have a better view in two places:

  • Directly in the Structure menu:


  • Along with the tests themselves, in the Structure section:


This section allows you to clearly identify the hierarchy, in this case between test suites and test cases.

Tip 3: Using the test environments

In a Test issue, test executions can be launched in the specific test environment:


This field Test Environments will be useful in two places:

Test Section

In the test execution section of a Test issue, add a Test Environments column to the table:


  • You will then see the result for each test, according to the environment used:


Test Coverage

In the applications which consider the requirements, you will be able to select the environment where you would like to know the test’s result:


And that is it! Three easy tips to improve testing using Xray and JIRA.

If you are interested in staying on top of all the latest tips and trends in the Atlassian ecosystem, make sure to take a moment to sign up to our monthly newsletter!

Cutted Triangle

Subscribe to the Valiantys Newsletter

Registered request ! Subscribing... This is not an email An error occured

In accordance with our privacy policy, we are committed to respecting your personal data.

Contact us

Our Atlassian certified consultants will be happy to answer you.

Join us

We're building the next dream team - Are you in?

Follow us

We use cookies for the operation of our website. This is to improve its use, to personalize your experience, and to compile visitor statistics. By continuing to use this site, you consent to this policy. You can manage the settings and choose whether or not to accept certain cookies whilst browsing. For more information, see our privacy policy. Our privacy policy

Privacy settings

In order to facilitate your navigation and to provide you with the best possible service, we use cookies to improve the site to the needs of our visitors, particularly according to the number of visitors. For more information, please read our privacy policy. Our privacy policy


Google reCAPTCHA is a system designed to distinguish humans from computers, so that bots are unable to maliciously fill out forms on behalf of a human being.


Used to send data to Google Analytics about the visitor's device and behavior. Tracks the visitor across devices and marketing channels. Used by the social sharing platform AddThis to store the user's usage history of the AddThis sharing widget. Registers a unique ID that is used to generate statistical data on how the visitor uses the website.


Targeting Cookies: Targeting cookies may be set through our site by our advertising partners. They may be used by those companies to build a profile of your interests and show you relevant advertising on other sites. They are based on uniquely identifying your browser and internet device. You can turn off the use of cookies for targeted advertising here. When the button is green, targeted cookies are on. When the button is red, targeting cookies have been turned off.

Social Media Cookies: These cookies are set by a range of social media services that we have added to the site to enable you to share our content with your friends and networks. They are capable of tracking your browser across other sites and building up a profile of your interests. This may impact the content and messages you see on other websites you visit. If you do not allow these cookies you may not be able to use or see these sharing tools.