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

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




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.
