Milestones are optional. You can continue using Test Runs without milestones if your workflow does not require deadline tracking.
1. Create a Project Milestone
To create a milestone, you have to be a Project Administrator. Please follow the instructions:
- Open your project.
- Go to the Milestones page.
- Click the ‘+ Milestone’button.
- Fill out the milestone details:
- Title:Enter a clear milestone name.
- Description:Add optional context, links, or release notes.
- Start Date:Set the beginning of the testing window, if needed.
- Due Date:Set the deadline for the milestone, if needed.
- Test Runs:Select the Test Runs that should belong to the milestone. You'll be able to add Test Runs later.
- Save the milestone.
Note: Project Milestones are created at the project level and do not apply across multiple projects.
2. Assign Test Runs to a Milestone
You can assign Test Runs to a milestone from:
- The Milestone details page.
- Test Run settings or Test Run details.
A milestone can include multiple Test Runs. Each Test Run can be assigned to one milestone at a time.
3. Understand Due Date Logic
If a milestone has a Due Date, assigned Test Runs inherit that due date.
When a Test Run inherits a due date from a milestone:
- The due date is shown on the Test Run.
- The due date is read-only on the Test Run.
- The milestone is shown as the source of the due date.
If a Test Run is not assigned to a milestone, you can set a manual due date directly on the Test Run.
Note: If no milestone is assigned and no manual due date is set, the Test Run has no due date by default.
4. Track Missed Deadlines
A Test Run is considered missed when:
- The due date has passed.
- The Test Run is not Completed.
Missed deadlines are highlighted in the Test Runs list and on the Test Run details page.
If the due date comes from a milestone, the Test Run will show the milestone as the source.
5. View Milestone Progress
The Milestones list helps you monitor testing progress across time-bound goals.
The list includes:
- Title
- Start Date
- Due Date
- Test Run status summary
- Completion progress
- Test Runs count
Use filters to focus on milestones by status, date range, or missed Test Runs.
6. Open Milestone Details
The Milestone details page gives a full overview of milestone progress.
You can view:
- Milestone title and status.
- Start and due dates.
- Total Test Runs list.
From the Test Runs section, you can open a Test Run, edit it, or remove it from the milestone.
7. Manage Milestones
Project Administrators can:
- Edit milestone details.
- Archive milestones.
- Restore archived milestones.
- Delete milestones.
- Assign or remove Test Runs.
Other project roles have read-only access to milestones.
What’s Next?
Use Project Milestones to organize testing around releases, deadlines, or regression cycles. For additional help, check related guides or contact support—we’re here to help!

