Releases

Releases let you group completed features and tasks into planned software deliveries. Track release status from initial planning through to deployment.

Release Lifecycle

stateDiagram-v2
    [*] --> PLANNED
    PLANNED --> IN_PROGRESS : Start work
    IN_PROGRESS --> RELEASED : Deploy
    IN_PROGRESS --> CANCELLED : Cancel
    PLANNED --> CANCELLED : Cancel
    RELEASED --> [*]
    CANCELLED --> [*]

Creating a Release

1. Navigate to Tasks > Releases
2. Click New Release
3. Fill in:
   • Name -- version or release name (e.g., v2.4.0, Q1 Release)
   • Description -- what this release includes
   • Target date -- planned release date
   • Project -- associated project
4. Click Save

Linking Features to Releases

Associate features and epics with a release to define its scope:

• From the release detail page, add features to include
• From a feature or epic, set the target release

The release overview shows progress based on the completion status of all linked items.

Release Progress

The release detail page displays:

• Completion percentage -- based on linked tasks reaching DONE
• Feature list -- all features in the release with individual progress
• Open items -- tasks still in TODO, IN_PROGRESS, or IN_REVIEW
• Target date -- with visual indicator if the release is at risk of delay

Best Practices

• Define releases early to give the team a clear target
• Link features to releases during sprint planning
• Review release scope regularly and defer items if needed
• Move the release to IN_PROGRESS once the first sprint targeting it begins
• Only mark RELEASED after successful deployment