How To Upload Test Cases In Jira Xray

Effective test management is crucial for creating top-notch software and Jira Xray is a leading test management tool in the industry. This blog post will walk you through the steps of uploading test cases in Jira Xray, making your test management a smooth and effortless process.


Before you upload test cases in Jira Xray, make sure you have the following:

  • Jira instance with Xray Test Management for Jira add-on
  • Administrator access for the Jira instance
  • A CSV/XLS file with the test cases you want to upload

Step-by-step Guide to Uploading Test Cases

Step 1: Prepare Your Test Cases for Uploading

The first step involves preparing your test cases in a CSV or XLS file. The file should include the test case name, precondition, steps, expected results, among other fields. Make sure to structure your file in a way that corresponds with the Xray fields.

Step 2: Navigate to Xray Importer

The next step is to navigate to the Xray Test Case Importer. Here’s how:

1. Log in to your Jira instance.
2. Navigate to ‘Xray’ situated in the top menu.
3. Click on ‘Import from CSV’ under the ‘Xray’ drop-down menu.

Step 3: Configure Import Settings

After you’ve navigated to the Importer, you’ll need to configure your import settings. Here’s what to do:

1. Click on ‘Choose File’, then select your CSV/XLS file.
2. Choose ‘Generic Test Case Importer’ as your import template.
3. Select the project you want to import the test cases into.
4. Map your CSV/XLS columns to the corresponding Jira fields.
5. Click on ‘Begin Import’.

Step 4: Review Import

Once you’ve clicked on ‘Begin Import’, Jira Xray will upload your test cases. After the import process completes, make sure to review your uploaded test cases. This ensures that all your test cases have been uploaded correctly.


And that’s it! You’ve successfully uploaded test cases in Jira Xray. With this feature, you’re able to manage your test cases more effectively, streamline your testing process, and ultimately, produce better software. Jira Xray, with its seamless integration with Jira, certainly takes software quality assurance to a new level.