Do you want to export your tests in a template compatible with the one to do the CSV import in the other hosting? 

Now you can! You just need to Xray's Document Generator (DocGen).


The templates can be changed to add or remove fields. You just need to adapt it to the information you need to export/import.

Template Scope Summary

All the templates linked in this article only take issues of type "Test" as input source. They rely on the capabilities described in this article (as well as the overall Document Generator ones). 

Out of the box, the fields included are 

KeySummaryTest TypePriorityComponentTest Repository Folder

Plus the test content details, depending on the type (Action/Data/Result, Gherkin Definition, Unstructured Definition).


In addition, you could leverage Jira mappings to add columns, keep in mind their relevance for reimporting though. Please note it is not possible to export the attachments themselves in this bulk scope.

Export and import tests: Cloud/Cloud and Cloud/Server

Download this template (for Cloud or Server; exports only manual tests).

Download this template (only Cloud; exports all test types).

Download this template (only Cloud; export all Test Types, Preconditions and Test Sets).


  1. Upload the template to your instance;
  2. Go to the Search for Issues page and search for the tests you want to export and do it using bulk export with DocGen;



  3. Open the exported file in Excel, make changes if needed, and then save the file as CSV;
  4. Open the Xray Test Case Importer and choose the CSV file (Choose the semi-colon delimiter)


  5. Do the following mapping and then begin the import:


Tips for the Issue ID column to make it an identifier instead of Key:

  1. Select the Issue ID column
  2. Go to Home-> Find & Select -> Replace.
  3. Fill the "find what" and "replace with" with what you want, for this you will filter by the Key of the project and replace it with empty space
  4. Click "Find All".
  5. In the lower part of the Find and Replace window it will show the table with all occurrences for that Column
  6. Click one row of that table and do Ctrl + A, it should select the whole table. The whole table selected
  7. Click Replace All

Export and import tests: Server/Server

Download this template.

  1. Upload the template to your instance;
  2. Go to the Search for Issues page and search for the tests you want to export and do it using bulk export with DocGen;
  3. Open the exported file in Excel, make changes if needed, and then save the file as CSV;
  4. Open the Xray Test Case Importer and choose the CSV file. (Choose the semi-colon delimiter).
  5. Do the following mapping and then begin the import:


Export and import tests: Server/Cloud

Download this template.

  1. Upload the template to your instance;
  2. Go to the Search for Issues page and search for the tests you want to export and do it using bulk export with DocGen;
  3. Open the exported file in Excel, make changes if needed, and then save the file as CSV;
  4. Go to Cloud instance, open the Xray Test Case Importer and choose the CSV file. (Choose the semi-colon delimiter).
  5. Do the following mapping and then begin the import:
Please take into consideration the required fields from different hostings. For Server, they are Test Case Identifier, Summary, and Action; for Cloud - Issue Id, Summary, and Test Type.


Xray Cloud - Document Generator

Xray Cloud - Importing Tests using Test Case Importer

Xray Server - Document Generator

Xray Server - Importing Manual Tests using Test Case Importer