Editing a Release

Editing Releases


Prior to Editing a Release

Prior to editing a release, there must be an existing project that has been created in Zephyr. The project must be selected and the user must have selected the manage release button explained in the Release Setup section.

Scenario: You are a testing manager that just created a project and you are managing your releases within the project. You currently have 2 releases in the system. As a testing manager, you want to make edits to an existing release in the project. You will be editing the release and changing the Name, Start Date, and End Date.

If this is your first time editing a release, you might want to create and work in a test project that doesn't affect another project, and work out any issues you might have with editing a release before you work in a live project.



1. In 'Manage Release', simply click on any release in the table to begin making edits and changes to the selected release.

2. A release detail section will appear below and this is where you'll be making edits to the releases. (In our scenario, we'll be changing only the Name, Start Date, and End Date)

3. After clicking on the release in the table., make changes to the Name of the release, Start Date, and End Date for the release.

The other fields are optional that can be filled out. Optional fields are displayed below for further explanation:

  • Description - A written representation to help provide an explanation for the release.
  • Hide - A way to hide or suppress a specific release 
    • Hiding a release will not delete any data.
    • Hiding a release will cause the release to not appear in the project's release drop-down list.
    • Users are able to access test cases via the Global Tree in the Test Repository.
    • Users are able to access read-only execution statuses in the Test Execution section of Zephyr.
  • Map External Defect Project - A way to map an external defect project from Jira to the release.


4. Simply click the "Save" button to finalize all the details of the release and the new release will be created.

5. You can immediately switch to the Edited Release and start using it right away.


Back to Top ^