What is the appropriate tool to Import test cases to JIRA/Zephyr?


I am interested in learning from the experience of veteran JIRA/Zephyr users.

Zephyr documentation points to zfj-importer-utility-0.29.jar to import test cases:

Is this the tool that we should be using to import test cases? If so, is there any documentation or examples of the structure of the Excel files?

Would it be more efficient to import test cases using the CSV files directly in JIRA? If so, what is the proper form of import steps of a test case?

Thank you,


1 answer

1 accepted

Hi Julia,

The preferred way is to use the importer provided by Zephyr which you have pointed out in your question. Reason being, this supports having multiple test steps within each test case. You will miss out on this functionality if you use the CSV importer for JIRA.

Using the importer is pretty straight forward and you will find the documentation in the overview page at https://bitbucket.org/zfjdeveloper/zfj-importer

Try it out on a staging environment, perform several test runs, and then import into production system.

Thank you for the feedback Bhushan! I wanted to make sure I was using the recommended tool. My hesitation was the result of attempting to import some fields were not present in zfj-importer-utility-0.29.jar for Test issue type, for example "Environment", and that XML import did not seem to work. I will determine the best way to work with zfj-importer-utility-0.29.jar. Julia.

Suggest an answer

Log in or Join to answer
Community showcase
Sarah Schuster
Posted Jan 29, 2018 in Jira

What are common themes you've seen across successful & failed Jira Software implementations?

Hey everyone! My name is Sarah Schuster, and I'm a Customer Success Manager in Atlassian specializing in Jira Software Cloud. Over the next few weeks I will be posting discussion topics (8 total) to ...

2,804 views 11 18
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot