(blue star) Zephyr for Jira is now Zephyr Squad! Read more about this.

The internal importer allows you to import your test cases from an Excel file right into your Zephyr for Jira project and this can be done right inside Jira without having to download and use a third party importer. The internal importer can be located on the Import Tests page within the Zephyr menu:

This functionality allows you to import tests based on a project level. Importing tests are done per project individually and are not imported globally across multiple projects.

We recommend using the internal importer because it allows you to save your configuration file (configuration for your mapping) and reuse it during future imports which saves you a lot of time when importing test cases. Also, the benefit of using the internal importer is that it is located directly in-app within your Jira and everything can be done seamlessly.

Note: If an ad blocker is enabled in your browser, you will get an error when trying to open the Import Tests page. To make use of the Import Tests feature, either disable the ad blocker for your Jira instance, or configure the ad blocker not to block Optimizely assets (optimizely.com).

Using the Internal Importer

1. Navigate to the Import Tests page.

2. Import test cases from Excel files by choosing a file to upload and import.

3. Define the row number where to begin importing:

4. Choose to import the selected individual sheet(s) or all sheets. Click Next.

5. Map your Excel fields to the default Jira/Zephyr fields. Use the drop-downs to select which Jira/Zephyr field you want it mapped to.

6. Validate the fields by clicking on the Validate button after setting up your mapping. This will do a preemptive mapping where possible and will validate the mapping to show what will be created and what will not be created when importing. If you don’t want to validate the fields, click Skip Validation:

7. After the validation is complete, you can save the configuration file if you are happy with the validated mapping.

8. If you are ready to import, click Begin Import.