Milestones
Milestones in Qualflare collect the launches you run for a release or sprint and show how their tests did. Deleting a milestone also deletes its launches.
Last updated
In Qualflare, a milestone groups the launches you run for a release, sprint or other checkpoint and shows how their tests did. Each milestone has one of seven kinds, and a new one defaults to Release.
| Where | Milestones under Planning in the project sidebar. A milestone opens in a side panel |
| Who | View: Viewer+ · project (requires the Viewer role or higher in the project); create, edit, complete and assign: Editor+ · project (requires the Editor role or higher in the project); delete in the app: Owner · project (requires the Owner role in the project) |
| Plans | Every plan, with no limit on how many milestones a project has |
| Linked to | Launches only: no test cases, defects or test plans |
| CLI | qf <identifier> milestones list, qf <identifier> milestone get <seq>, and --milestone on qf <identifier> collect (Milestones commands) |
| MCP | list_milestones and get_milestone, read only (MCP server reference) |
| Data loss | Deleting a milestone deletes its launches. See Delete a milestone |
How milestones work
A milestone marks a checkpoint you test toward, and you link the launches you run for it:
- Releases: "v2.0", "Q1 GA"
- Sprints and iterations: "Sprint 24", "Iteration 5"
- Test cycles: a regression cycle before a release
Each milestone has a Kind that says which it is: Cycle, Feature, Iteration, Plan, Release, Sprint or Version. A milestone holds:
- Name and Description
- Kind, which defaults to Release
- Due Date
- Assignees: the people responsible. Other people you assign get an in-app notification and an email.
- Launches: the test runs linked to it
A milestone has no list of test cases and no linked defects. You only link launches to it.
Milestones vs test plans
A test plan selects which cases to run. A milestone collects the launches you ran for a release, and the two aren't linked to each other.
The milestones list
The milestones list shows every milestone in the current project.
Columns
| Column | Description |
|---|---|
| Name | The milestone's kind icon, its number (for example #12), and its name |
| Date Created | When the milestone was created |
| Last Update | When the milestone last changed |
| Due Date | The milestone's due date |
| Health | A bar of passed, failed, error, skipped, timeout, and aborted results |
| Assignees | People assigned to the milestone. Pick them from the project's members |
Search
Use the Search milestones... box to find milestones by name. The list has no other filters.
From the CLI, search with qf <identifier> milestones list --query "v2.0".
Sorting
Click a column header to sort by Name (milestone number), Date Created, Last Update, or Due Date.
To edit, complete or delete a milestone, open it. See Milestone panel. The list's own actions don't work: Mark as completed in a row's menu and the bulk Complete button fail with an error, Delete in a row's menu does nothing, and the bulk Archive button only shows "Archive coming soon".
Create a milestone
Editor+ · project (requires the Editor role or higher in the project)- Go to Milestones and click Create Milestone.
- Fill in the fields below.
- Click Create.
| Field | Required | Notes |
|---|---|---|
| Name | Yes | 3 to 128 characters. Longer names fail to save. |
| Description | Yes | Up to 256 characters. Longer text fails to save. Qualflare doesn't save a milestone without a description. |
| Kind | Yes | Cycle, Feature, Iteration, Plan, Release, Sprint or Version. Defaults to Release. |
| Due Date | Yes | Any date, past or future |
Milestone panel
The milestone panel is the side panel that opens over the list when you click a milestone. Press Esc or use the close button to close it.
The header shows the milestone number and name, an Active or Completed badge, the kind, when it was created and the description. Below that are four values:
| Value | What it shows |
|---|---|
| Type | The milestone's kind |
| Due Date | The due date, or "Not set" |
| Launches | How many launches are linked |
| Health | A bar of the result counts |
The More options (⋯) menu holds Edit, Mark Complete (Reopen on a completed milestone) and Delete. Mark Complete and Reopen don't work, so use Edit to complete or reopen a milestone.
| Tab | What it shows |
|---|---|
| Overview | Test Health: result counts by status, with the Pass Rate |
| Health | The latest run of each suite in the linked launches, with the pass rate on the tab |
| Launches | The linked launches, with State, Type, Branch, Environment, Platform and Date Created. Click a launch's Launch at link in the State column to open it. |
| Comments | Discussion about the milestone |
Link launches to a milestone
Launches are what you link to a milestone. You don't add test cases to it.
- Manual runs: go to Launches > Start Launch, choose the suites, then pick the milestone in the optional Milestone field. Completed milestones aren't listed. The Milestone field lists only the open milestones among the project's first 10 milestones by number, so a newer milestone may be missing from it. See Start a manual launch.
- Uploaded results: pass the milestone number to the CLI, or set
QF_MILESTONE:
qf <identifier> collect results.xml --milestone 12If the project has no milestone with that number, Qualflare refuses the upload and creates no launch, and qf's error includes milestone #12 does not exist in this project.
See collect for the other options. In CI, set QF_MILESTONE once for the job; see CI/CD.
Edit a milestone
Open the milestone and choose More options (⋯) > Edit. You can change:
- Name (at least 3 characters)
- Description (at least 3 characters)
- Due Date
- Type
- Is Completed, and Date Completed while it's on
Click Save to apply your changes. Cancel or Esc discards them.
Complete or reopen a milestone
A milestone is either Active or Completed, and it stays Active until you complete it. Qualflare never completes a milestone on its own, and runs no checks before you do. The list doesn't show the status: open the milestone to see its badge.
- Open the milestone and choose More options (⋯) > Edit.
- Turn on Is Completed. Optionally pick a Date Completed.
- Click Save.
The badge changes to Completed. To reopen the milestone, turn Is Completed off and save. Completed milestones don't appear in the Milestone field of Start Launch. Mark Complete and Reopen in the menu don't work, so use Edit.
Many teams agree on a checklist before they complete a milestone, such as "all critical tests pass" or "no open Critical defects". Qualflare doesn't enforce it.
How milestone health is calculated
Milestone health counts the results of the launches linked to the milestone:
- Only launches linked to the milestone count.
- For each suite, only its most recent run across those launches counts.
- Health counts that run's case results by status: passed, failed, error, skipped, timeout and aborted.
- Pass rate is passed results divided by all results. Skipped, timeout, aborted and error results all lower it.
- Defects don't affect milestone health.
Before a release, check open defects separately: filter Defects by Status and Severity. See also Check milestone health.
Delete a milestone
Deleting a milestone permanently deletes every launch linked to it, with all of their suite results, case results and comments. Test cases and defects are kept. This can't be undone, and the confirmation doesn't mention the launches. To close a milestone and keep its launches, complete it instead.
To complete it, open Edit and turn on Is Completed, as Complete or reopen a milestone shows.
Owner · project (requires the Owner role in the project)- Open the milestone and choose More options (⋯) > Delete.
- In Delete Milestone, click Delete.
Permissions
| Action | Role |
|---|---|
| View milestones and their launches | Viewer+ · project (requires the Viewer role or higher in the project) |
| Create, edit, complete, reopen and assign | Editor+ · project (requires the Editor role or higher in the project) |
| Delete in the app | Owner · project (requires the Owner role in the project) |
Your role on a project is the higher of your project role and your workspace role. In the web app today, buttons follow your project role. See Roles and permissions.
Qualflare records creating, editing, completing, reopening, assigning and deleting a milestone in the workspace audit log Scale and above (available on Scale, Enterprise, Open Source).
Limits and availability
Milestones are on every plan, and a project can have any number of them. Name is 3 to 128 characters, Description is required and up to 256 characters, Kind is one of the seven kinds and Due Date is required. Longer text fails to save.
Related
- Guides: Start a manual launch · Run tests in the Test Wizard · Upload results with qf collect · Check milestone health
- Reference: Launches · Environments · Test Plans · Defects · Roles and permissions · Glossary: Milestone
- CLI/API: Milestones commands · CI/CD · MCP server reference
Import and export test cases
Import test cases from Qase, TestRail, Testmo or Allure TestOps, and export your suites as a ZIP of CSV files. Qualflare can't re-import its own export.
Shared Steps
Shared steps in Qualflare are reusable step sequences, such as a login, that you insert into many test cases. Editing one changes every case that uses it.