Integration for Zephyr

Zephyr is an add-on application for JIRA that is used for test management. The integration provides traceability and result synchronization between Squish Test Center and Zephyr. The integration allows you to manually map Zephyr tests to Squish test suites and cases.


To use the Integration with JIRA cloud or JIRA server, install and activate the Zephyr Squad JIRA add-on:


Administrators can turn on Zephyr Integration in Global Settings.

Adding Zephyr JIRA account information to Squish Test Center

The Zephyr integration supports basic authentication and OAuth 1.0a. In Authorization Method, select Basic or OAuth. To use the OAuth 1.0a authorization method, follow the instructions in JIRA authorization method.

For basic authentication, set the following options:

  • Server URL is the URL of the JIRA instance
  • Username
  • Password

Click the Update button to save the information you entered.

Click the Sync Projects button to fetch Zephyr projects and make them appear in the Associations list, where you can map each Zephyr project to its Squish Test Center counterpart.

Cloud configuration

If you use Zephyr for JIRA cloud, turn on Cloud and enter authorization data from your JIRA cloud instance.

Cloud settings

To obtain the values for the Zephyr API key and Zephyr API secret fields:

  1. Select the Zephyr project in JIRA.

  2. Select Zephyr Squad.

  3. Select API Keys.

To get the value of the JIRA user id field, go to the Profile view, and copy the id from the browser URL field.

Traceability view

To open the Traceability view, select Zephyr in the History or Explore view of an associated project.

At first, the table is empty. To fetch Zephyr tests from the Zephyr server, click the Pull button. If there are lots of tests or test steps, pulling can take some time. Consecutive pull operations done the same day take less time because the progressive pulling mode is used. This means that deleted tests are not removed from the traceability table until a complete pull is performed. Switching between complete and progressive pulling is done automatically, so that a complete pull is done once a day.

To map the pulled Zephyr tests to tests managed by Squish Test Center in the Traceability view, click the Edit button of a table entry in the Mapping column.

Versions and test cycles

Click the Push button to set Versions and Test Cycles, or push using the default values.

Zephyr Push Dialog

Creating Zephyr tests from Squish Test Center

You can create a new Zephyr test case from an existing Squish Test Center test in the Actions column in the Explore view. In the Create Zephyr Test dialog, specify the following settings:

  • Project is needed if more than one project is associated to the same Squish Test Center project
  • Summary corresponds to the test name displayed in Zephyr
  • Description

Select Create test steps automatically to not only create the currently selected Squish Test Center test in Zephyr but also create its children as steps in Zephyr. For example, when you create a Zephyr test from a scenario, all steps of the scenario are also created.

Zephyr test creation

© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners.
The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.
Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.