> ## Documentation Index
> Fetch the complete documentation index at: https://docs.testdino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Test Releases

> Group runs and sessions under a release, plan scope and timeline, and roll up manual and automated progress into one number.

A release is the planning container for a sprint, version, or cycle of testing. It captures scope, dates, branch, environment, build target, and testers, then rolls up progress across every linked run and session.

<img src="https://tdstorageus.blob.core.windows.net/public/docs/test-management/manual-testing/releases/manual-testing-releases-list.webp" alt="Releases page showing active releases with status, runs, sessions, and timeline" />

## Create Or Edit Release

Click **Create Release** on the Releases page to open the release form. The same form is used for editing: open a release, click **...** in the header, then **Edit**.

| Field | Description |
| :- | :- |
| `Name` | Release name |
| `Description` | Long-form description |
| `Type` | Value from [Release Type Settings](#release-type-settings), e.g. `release`, `hotfix`, `patch` |
| `Parent` | Optional parent release; see [Release Scope](#release-scope) |
| `Start Date` | Planned start date |
| `Due Date` | Planned due date; drives the `Past Due` status |
| `Branch` | Source-control branch |
| `Environment` | Target environment from project settings |
| `Build target` | Platform, version, build number, source, and deploy URL |
| `Testers` | Assigned testers; must be organization members |
| `Linked issues` | Jira or Linear issues, by key or URL; same field as on runs, see [Link Work Items](/test-management/manual-testing/manual-runs#link-work-items) |
| `Note` | Internal note with inline image support |

<img src="https://tdstorageus.blob.core.windows.net/public/docs/test-management/manual-testing/releases/manual-testing-releases-create-dialog.webp" alt="Create Release dialog showing name, description, type, parent, dates, branch, environment, build target, testers, linked issues, and note fields" />

## Release Scope

From a release's detail page, you can add 3 items: a test run, an exploratory session, or a sub-release.

<img src="https://tdstorageus.blob.core.windows.net/public/docs/test-management/manual-testing/releases/manual-testing-releases-detail.webp" alt="Release detail page showing options to add a test run, exploratory session, or sub-release" style={{ maxWidth:"100%"  }} />

* **Test run** - Creates a [manual run](/test-management/manual-testing/manual-runs) under this release. Good for a fixed list of test cases, like a smoke check before a deploy or a regression pass.

* **Exploratory session** - Creates a [session](/test-management/manual-testing/sessions) under this release. Best for unscripted testing where you set a mission, explore, and log findings as you go.

* **Sub-release** - Creates a child release inside this one. Useful when a long cycle needs to split into phases, like a major version broken into a beta phase and a final phase (`v2.0 → Beta → Final`).

<Callout icon="circle-info" color="#3B82F6">
  **Note**

  * Items added from the detail page link automatically to the release.
  * Sub-releases support up to 3 levels.
</Callout>

## Track Progress on Release Detail

The detail page shows the release status, dates, edit options, and action buttons. Use the `Results` tab to track test progress and the `Activity` tab to see its runs and sessions.

### Release States

Releases move through `Not Started`, `In Progress`, and `Completed`. `Past Due` appears if the due date passes before completion. Use Start, Complete, or Reopen to update the release state. Linked runs and sessions must be closed separately.

### Results Tab

The `Results` tab combines test case results from every run in this release and its sub-releases. Session findings are counted in their own breakdown.

A test case that appears in more than 1 run counts once, using its most recently updated entry. Adding a case to a new run shows it as `Untested` until someone records a result. A case a tester passed by hand and CI later failed counts as failed, the same way it reads inside the run.

Automated results reach a release through its runs. Pick the CI run on the run itself, under **Read automated results from**.

A release is only as accurate as the links behind its automated cases. A wrong or broken link reports the wrong result in the run, and the release rolls that number up without questioning it. See [Keeping links accurate](/test-management/test-cases/list-view#keeping-links-accurate).

<img src="https://tdstorageus.blob.core.windows.net/public/docs/test-management/manual-testing/releases/manual-testing-releases-results-tab.webp" alt="Release detail Results tab showing test status breakdown, progress, note, and sub release sections" />

### Activity Tab

The `Activity` tab lists the release's runs and sessions, newest first, with each one's status and who created it.

<img src="https://tdstorageus.blob.core.windows.net/public/docs/test-management/manual-testing/releases/manual-testing-releases-activity.webp" alt="Release detail Activity tab showing contributors and recent activity across linked runs and sessions" />

## Release Type Settings

Use `Type` to categorize releases. You can also customize and manage these values via **<Icon icon="gear" /> Test Case Settings → `Test Execution → Releases → Release Type`** in the header.

<img src="https://tdstorageus.blob.core.windows.net/public/docs/test-management/manual-testing/releases/manual-testing-releases-settings.webp" alt="Settings page showing Releases tab with Release Type options" />

<CardGroup cols={2}>
  <Card title="Runs" icon="play" href="/test-management/manual-testing/manual-runs">
    Track manual and automated cases inside a release
  </Card>

  <Card title="Sessions" icon="compass" href="/test-management/manual-testing/sessions">
    Track exploratory work linked to a release
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.