Skip to content

Releases

You can use the Releases activity to manage GitHub releases.

To show the Releases activity, click its activity-bar icon or click DevOps > Releases.

Releases are listed chronologically and display the following information.

  • Name: The name of the release.
  • Status badge: A badge that indicates whether a release is a Draft, Pre-release, or the Latest release.
  • Label: The label attached to the release.
  • Timestamp: How long ago the release was published.
  • Release notes: A snippet of the release notes.

To open a release in a separate tab, right-click the release and click Open in New Tab.

Create a release

To create a new release, complete the following steps.

  1. Click DevOps > New Release.
  2. In the New Release tab, enter the tag of the release in the Tag field.
    If a new tag is created, enter the destination branch of the tag in the Target branch (for new tag) field.
  3. In the Release title field, enter the title of the release.
  4. In the Release notes field, enter the description of the release.
  5. Select This is a pre-release to mark the release as a pre-release. Select Set as the latest release to mark the release as the latest release.
  6. Click Publish Release. Click Save as draft to save the release as a Draft.

Filter releases

Click the Show filters icon to open the filter panel. Type a release name, tag, or author in Filter releases to find matching releases. Select Published, Drafts, or Pre-releases in Status to show only those releases. Press Ctrl+F (Cmd+F on macOS) to focus the search field.

The line above the list names each filter that is set. Click a name to change it, or click Clear filters to clear all of the filters.

Release view

Click a release to open the release in Release view. The Release view displays the full release notes, release tag, the author of the release, the date the release was published, and all release assets.

Release actions

In the Release view, click the Edit icon to edit the release title and release notes. For pre-releases, click the Promote icon to mark the release as the latest release. For published releases, click the Pre-release icon to mark the release as a pre-release. Click the Delete release icon to delete the current release.

In the Assets section, click the Upload Asset icon to add an asset to the release. Each asset lists the file size and the number of times the asset was downloaded.

Click the Open icon to open the asset in a web browser. Click the Delete asset icon next to an asset to delete the asset.

Click the Download icon next to a source code asset to download the source code.

Draft release content with Zide

Use Generate in the Release content header to draft the title and notes together. Its label stays visible when the fields contain text. Hover or focus the button to highlight both fields. Existing drafts open a review with selectable results, and applied results offer Undo. Review the content before creating the release.