ITSM Webinar, June 17: Start bringing visibility to your systems with Jira Service Management and Insight. Register here.


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:

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:

a – Choose the CSV source file.

b- Make sure the CSV delimiter is defined correctly.

c- Check your File Encoding.

d- 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.

Talk to us


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.

Tag Manager

These cookies allow us to employ data analytics via Google Analytics and Google Tag Manager so we can measure and improve the performance of our site and provide more relevant content to you. These cookies don't collect information that identifies a visitor down to an individual level that is available to us. These cookies are not passing personally identifiable information to any external third party other than in limited cases when we engage a service provider to act on our behalf but who is then unable to use the data for their own purposes.


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.