Skip to main content

Migrating from Zephyr to Testiny

This guide shows how to migrate test cases from Zephy in Jira Server/DC (previously Zephyr Scale) to Testiny. We recommend using our importer that uses the Zepyhr API where you can migrate test cases including attachments, custom field values, text formatting and linked Jira requirements.

info

If you would like to migrate from Zephyr Essential from Jira Cloud, please don't hesitate to contact us at [email protected].

info

If you encounter any problems while importing your existing test cases or migrating from another tool, please do not hesitate to ask in the forum. Our support team is always available to assist you.

Testiny supports the migration via Zephyr API so that you can migrate your test cases with ease. Follow these steps to migrate your tests per project:

  1. Go to the test cases in your Testiny project and start the 'Import':

Folders menu item 'Import'

  1. Choose the option Zephyr API.

  2. Enter your Zephyr API credentials: provide the URL to your Jira DC/Zephyr instance and an API Key to access Zepyhr.
    Then click Connect.

note

Please note, that the Jira DC/Zephyr instance must be publicly reachable so that Testiny can send API requests and migrate the data.

  1. You can now import your existing test cases:

    • Choose from which Zephyr project you would like to import the test cases.
    • If you have been using Jira to track requirements, you can also configure a Jira integration in Testiny and migrate linked requirements as well.
    • If you just want to try the migration, you can also set a limit to only retrieve a small number of test cases.

  2. After selecting a project, Testiny retrieves the test cases from Zephyr, automatically detects the available settings, and displays the corresponding field mapping.
    Field mappings define how fields from your Zephyr test cases are aligned with fields in Testiny.
    Confirm the automatic mapping (and apply any manual adjustments if needed) to get a preview of the test cases that will be imported.
    You can re-adjust the field mapping anytime in the importer settings.

  3. Finally, if there are no errors and you're satisfied with the preview, click Import to finalize the import and add the test cases to your project.
    A summary dialog appears after the import, showing detailed statistics and any error messages. Copy the data to the clipboard (Copy all data to the clipboard) or dismiss the dialog by selecting either Save summary and close (this action downloads an HTML report of the import) or just Close.