Skip to content
Zide Zide Zide

Releases

You can use the Releases activity to manage GitLab releases.

When more entries are available, use Load more at the end of the list. A line above the list says how many releases there are.

In the activity panel, New Release, the filter icon, and More actions share the title row with the source badge.

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 if a release is the Latest release.
  • Tag: The Git tag of the release.
  • Timestamp: How long ago the release was updated.
  • Release notes: A snippet of the release notes.

In the activity panel, open More actions and select Compact Mode under View to show each release on one line with its status icon, name, and time. A check mark shows when it is on. In a separate tab, use the Toggle compact mode icon. Hold the pointer over the status icon to see whether the release is the latest release or published. Hold the pointer over the name to see the tag. More actions contains New Release, Show Filters, and Compact Mode.

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 the tag is new, the Target (for new tag) field shows the repository’s default branch. To create the tag on a different branch or tag, enter or select it. To create it on a commit, enter the commit SHA. The field is hidden when the folder already has the tag.
  3. Optional: In the Release date field, enter when the release will be published.
  4. In the Release title field, enter the title of the release.
  5. In the Release notes field, enter the description of the release.
  6. Click Publish Release.

A red asterisk (*) marks a required field. Publish Release is unavailable until the Tag field has a tag and, for a new tag, Target (for new tag) has a target that the repository has. Point to Publish Release to see the reason. If you leave the Tag field empty, a message shows below it.

Filter releases

Click the Show filters icon, then type a release name, tag, or author in Filter releases to find matching releases. Press Ctrl+F (Cmd+F on macOS) to focus the search field.

The line above the list says how many releases match, for example N matches. Zide filters the releases it has read, so while more releases remain, it says N matches so far; click Load more to search further. With no text, it says N releases, or N releases loaded when GitLab gives no total. The text you typed shows as a chip above the count. Click the chip to change the text, or click its x or Clear filters to remove it.

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 Edit to change the release title and release notes. Select More actions > Delete to delete the release. Zide does not offer draft or pre-release commands for GitLab releases.

In the Assets sections, click the Add Link icon to add an asset link to the release. In the Add Asset Link dialog, enter the URL, name, and specify what type of asset the link is. Add Link is unavailable until the URL and Name fields have text.

Click the Open Link icon to open the asset link in a web browser. Click the Remove link icon next to an asset link to delete the asset link.

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.

Assist with This

Right-click a release and point to Assist with This. In the Release view, you can also right-click the content header or an ordinary background area, or click More actions.

Under Zide Assist, click Add to Conversation to attach the release to a Zide Assist tab. You can also drag the release into a Zide Assist tab. For more information, see Attach items to a message.

Under Ask Zide, click Open Ask Zide. Zide opens the release in the Release view with an Ask Zide panel beside it. In the panel, click Summarize Release or Review Release Notes. Ask Zide does not edit or publish the release. See Ask Zide beside a tab.

Activity indicator

A failed release operation turns the Releases activity icon red. Drafts, published releases, and workflow failures do not change this icon. Workflow failures appear on Actions or Pipelines.

By default, failures stay red until the same operation succeeds. To clear failure indicators when you view Releases, turn off More actions > Failure indicator > Keep failure indicator after viewing. This choice applies across projects and persists across restarts. Failed-operation notices describe this app session.

The Releases panel also names retained failed operations. The notice remains until the same operation succeeds, even if you clear its activity indicator by viewing the panel. Notices belong to the current project and release source and last for this app session.