Xray Test Management for Jira tutorial: How to import manual tests

Are you getting started with Xray Test Management for Jira? Chances are that you may want to import your existing test cases, which are probably residing in multiple spreadsheets or even another test management tool. We’ll walk you through how to import manual tests into Xray by using a simple CSV file.

Before you get started:

  • Make sure you install Xray Test Management for JIRA from the Atlassian Marketplace.
  • Identify your test management project to include Test issue type or create a new project with Xray Test Project template.

Prepare the CSV

The screenshot below shows a sample test case which is managed using an Excel spreadsheet. Your test cases, normally saved in an XLS format, will need to be exported into a tabular formatted CSV file.

Remember to map the three mandatory fields:

  1. Test Case Identifier: This field identifies which lines belongs to which test case. In the example below, it is the TCID column. The TCID is used to associate the different test steps.
  2. Summary: This field is mandatory, as Jira doesn’t allow users to create an issue without a summary. In the example below, it is the Summary column.
  3. Manual Test Step: This field is going to be mapped as the Step field, Data field, and Expected Result field of a Manual Test Step. In the example below, it is the Step, Data, and Expected_Result column.
Tip: When exporting to CSV, remember to choose a delimiter that can exclusively separate the field values (such as “;” or “,”). We used “;” as delimiter in this tutorial.

If you open the CSV file using a standard text editor, then you will see it formatted as follows:

Import your test cases into Xray Test Management for Jira

The following steps will show you how to import your test cases, allowing JIRA to become a powerful test management tool.

1. Login with an administrator account and got to External Issue Import.

2. Next, choose the Xray Test Case Importer as follows:

3. Setup the basic settings for importing the CSV file:

  1. Choose the CSV source file.
  2. Make sure the CSV delimiter is defined correctly.
  3. Check your File Encoding.
  4. Optionally, choose the configuration file if you saved your settings from your previous import.



4. Map your Xray test Project, Fields, and Field values and click Begin Import:


Afterwards, your status page will show the import results. If you’d like to take a closer look at the results, click on the download a detailed log link.

Tip: If you plan to import another batch of tests, then don’t forget to save the configuration file so you can use it next time.



5. Go to your selected test project to view the imported tests:


The order of test steps will be as listed in your CSV file. If you need to change the order later, simply drag-and-drop your steps:


Leave us a comment if you have any questions, suggestions or feedback! Likewise if you need more one-on-one help with your Test Management solution in Jira, contact the Valiantys team below.

Cutted Triangle

Subscribe to 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.