Releases

Group issues that ship together in a team pipeline, then track stage, notes, and changelog.

Group issues that ship together and track them through a pipeline.

If Releases is missing from the team sidebar, ask a workspace admin to enable it.

Overview

A release is a named ship-batch of issues in a pipeline. Cycles plan when work happens; a release describes what ships together. An issue can belong to both.

Open Releases under a team (/releases?team=…, G then L). The list is team-scoped. Open Pipeline settings from a pipeline to configure stages (/settings/releases).

Release pipelines

A pipeline owns a set of stages. Stage types are Planned, Started, In Progress, Released, and Canceled. Released and canceled stages are frozen by default so new releases are not auto-assigned there.

To create a pipeline:

  1. Open Releases or Pipeline settings (/settings/releases)
  2. Click New Pipeline or Create new pipeline
  3. Set Name and optionally Teams (ownership; issues from other teams can still be added)
  4. Add and order Stages, then save

Open Pipeline settings from a pipeline's overflow menu. Deleting a pipeline removes its stages and releases and detaches those releases from their issues; the issues remain. That cannot be undone. Creating a pipeline needs create permission — otherwise Pulse tells you to ask a team manager.

Releases

  • Click New Release on Releases
  • Choose Create new release from pipeline or release actions
  • Set Release on an issue (Alt R) and create one from the picker

Give the release a name, optional Version, Target date, Stage, and Assignee. Click Create release.

Add issues from the release with Add issues, from an issue with Add to release…, or in bulk from a list. Issues can come from other teams than the pipeline's owners. Remove from release detaches an issue without deleting it.

Move a release between stages as it progresses. Progress on the release is based on its issues.

To delete a release, choose Delete. Attached issues are detached. This cannot be undone.

Viewing an issue's releases

On an issue, set Release in properties (Alt R) to see and change which release it belongs to.

Release notes

Each release can have notes. Use Add release notes… or Write with Agent after the release has issues.

Changelogs

Open a pipeline's Changelog tab (/releases/{pipeline}/changelog) to read notes in order.

Last updated on