Supported Jira versions
Zephyr Enterprise integrates with –
Jira Cloud, and
Jira Server / Data Center ver. 7.0 - 8.11
You can connect your Zephyr instance to multiple Jira instances, if needed. Each Zephyr project works with one Jira project only.
How it works for users
Users can assign Jira tickets to Zephyr items and view assignments on Zephyr’s Defect Tracking screen:
Set up Jira integration
This is a multistep process that varies depending on the authentication type you use to connect to Jira. See the following page for complete information:
Tip: To connect to Jira, you can use either OAuth, or Basic authentication (the latter is also called cookie-based in Zephyr UI). Basic authentication is easier for configuring, but OAuth is more secure. We’d recommend using OAuth connections, where possible.
Jira Integration screen
In Zephyr, you create, view, edit and delete Jira connections in the Administration > (System Setup) Jira Integration screen:
To create a connection, click Setting up Jira Integration.at the top of the list and follow the instructions you see on screen. Depending on the connection type you choose, you may need to configure your Jira instance beforehand. See
You can apply one of the following actions to a connection in the list:
Invokes a dialog box where you can configure Zephyr-side connection settings. The dialog is different for OAuth and Basic authentication connections.
Tests the connection.
Deletes the connection.
Notes on integration
Click Update webhooks on the Jira connections screen to update existing webhooks in all connected Jira instances, and to remove those webhooks that are not needed.
Custom fields of Jira items
Jira items can have user-defined (or custom) fields of various types: single-line and multiline text boxes, single-choice and multi-choice lists, radio buttons, labels, user pickers, URL fields, date pickers, and many others.
Zephyr supports these fields, that is, users can view and update these fields' values directly from the Zephyr UI.
To streamline operations, it may cache some field values (see below). You might need to update the cache manually.
Caching Jira data
Zephyr caches some Jira data to speed up user operations. It updates the cache at regular time intervals, but you might need to do this manually in the Defect Admin screen. See Caching Jira Data for details.
A possible alternative to Jira is using Zephyr’s built-in defect tracker. See Defect Tracking.