Create a new defect

1. Click Defect Tracking in the pane on the left, and then click Create Defect in the top-right corner of the Defect Tracking window:

2. In the subsequent dialog, select the project you want to create a defect for from the drop-down menu, select an issue type, and click Next:

3. In the resulting window, populate all the required fields (the ones marked with a red asterisk) and specify any relevant information in the other fields, if needed:

Required fields:

Value	Description
Project	The name of your project.
Issues Type	The type of your issue. The following options are available: Bug Epic Story Task Test
Summary	A short description of the issue.
Description	Detailed information about the issue.
Reporter	The user who reported the issue.
Linked Issues	Indicates whether the issue you are creating affects or is affected by other issues (whether it is blocked by some issue, whether it relates to some issue, and so on).

4. After you populate all the relevant fields, click Create.

If you don’t specify a value in the Priority field, Zephyr will set the default value - Medium.

5. Zephyr will show the Update Defect window (see below) where you can check the information you have specified, enter additional values, and attach files to your issue:

The total size of the attached files cannot exceed 20MB.

6. Click Update to complete the issue creation. Once done, you will be able to find the issue in Jira.

Update Defect window

The window shows the same values your issue has in Jira, including the values of the Sprint, Epic Link, Linked Issues, and Team fields:

If you update the values in Jira, you may not see them immediately in Zephyr, as the latter shows cached data. Zephyr updates the data every two hours, unless the administrator clears the cache on the Administration > Defect Admin page:

So, if, for example, a new Sprint value has been specified in Jira and you don’t see it in Zephyr, you may ask the administrator to clear the cache for the Jira fields.

Due to a Jira bug, it’s impossible to update a defect on the Update Defect page if the Team field contains a value.
When creating a defect in Jira, make sure it has the same set of fields defects have on the Create Defect and Update Defect pages in Zephyr. Otherwise, you may face issues when working with it.

Create defects using Wiki markup

You can use Wiki markup for the description when creating a defect in Zephyr.

To do that, select As wiki markup from the drop-down menu in the Description section:

The drop-down menu is active only if you are creating a defect from the Test Execution page.

To view the Wiki markup formatting you set up for the defect, navigate to the defect in Jira:

The Wiki markup should reflect the Wiki markup formatting you had when creating the defect in Zephyr.

If the Wiki markup is displayed incorrectly, we recommend that you double-check your Wiki markup formatting for the defect in Zephyr.

Remote Issue Links in JIRA

If the Remote Issue Links configuration has been set up in JIRA Customizations, then a remote link is sent to that particular defect in JIRA indicating that a Zephyr test case has been linked to it. It shows the test case ID, the summary, the test cycle in which it was executed, and the status of that test case execution.

This shows up in the Issue Links section of that defect in JIRA:

Clicking on the test case ID transfers the user back to the test case in Zephyr.

Browser not supported