Switch from another test tool¶
- In the web client, open Library → Import from another test tool. Select the export file, the optional ZIP of attachments and the target test unit. Select Continue.
- Choose TestRail, Xray, Zephyr, Qase or Neutral. Enter an identifier for the source project, such as shop-qa. Reuse it for later exports from that project. Select Review import.
- Check the source ID, title and other recognized fields. Adjust columns under Edit mapping and profiles, then select Update preview. To reuse a mapping, name it and choose Save mapping profile. On the next upload, choose the profile for that source and select Use profile.
- Review the proposed cases and omissions. Select Import reviewed package. Open an imported case from the receipt and check its contents and attachments. The receipt lists skipped columns, rows and files.
For another export from the same project, use the same provider, source identifier and target test unit. An identical case is recognized and linked in the receipt. If the database is busy, retry the reviewed import.
Sample files¶
| Source | Download | What the preview recognizes |
|---|---|---|
| TestRail | CSV | ID, title, section, preconditions, steps and expected result |
| Xray | CSV | Jira issue key and summary, description and step fields included in the export |
| Zephyr | XLSX | Case key, name, folder, preconditions, steps and expected result |
| Qase | CSV | Case ID, title, suite, preconditions and steps with expected results |
| Neutral | XLSX | Case ID, name and companion sheets for attachments and dependencies |
Download the sample ZIP as well. Each package references different files in it. The preview lists unused ZIP entries as omitted.
Limits and permissions¶
You need permission to create cases in the target test unit. The wizard accepts XLSX and UTF-8 CSV case tables. Column names can vary by product and export option. For Xray, export Test issues. Steps are available when included as an export column. Keep IDs with leading zeros as text.
Attachments use relative paths within the supplied ZIP. A mapped table column supports one path per row. The neutral format supports multiple attachments and dependencies in companion sheets. The importer transfers test case contents. Run history stays in the former tool. Review changed cases, local edits and matching names before importing again. Windows shows the imported cases and files in the library.