# Milestones

{% hint style="info" %}
**Who can use this feature**

All Project users can convert a Task to a Milestone.

***

Task Owners, Assignees and Admins can edit the Milestone Target Date.
{% endhint %}

Milestones mark critical points in your project, from contract deliverables to site handovers. In Aphex, they work just like Tasks, so you can assign all the same details: like Owners, Resources, Subcontractors,  Blockers, Work Areas, and Delays.

Milestones can include a fixed Target Date, giving you a reference point to track progress against. The Gantt will summarise & highlight whether you're on track or slipping, across all your Milestones.

## Creating Milestones

***

To create a Milestone, convert any existing Task or Subtask, or import Milestones directly from your Master Schedule.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FW3EqkeBwV4rLoIduBKyn%2FConvert%20to%20milestone.svg?alt=media&#x26;token=3f8d982a-115e-43ba-aa2d-061abd5f211c" alt=""><figcaption></figcaption></figure>

**Create a Milestone from the Gantt:**

* Hover over the task name
* Click  <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FunU6FaTKiBE8xXhg6N0j%2Foverflow%20button.svg?alt=media&#x26;token=5a3f3ce9-9039-4119-a28e-f4d2a2189ced" alt="" data-size="line"> and select `Convert to Milestone`

<details>

<summary>Milestone Conversion Logic</summary>

* Each Milestone spans at least one day, just like every Task in your plan.
* Only Tasks and Subtasks can be converted to Milestones
* When converted, the Milestone keeps all its original Task properties, including duration, delay history, owner, and assigned resources
* Attempting to set the Duration to 0 will also trigger the Convert to Milestone flow
* You can convert a Milestone back into a Task or Subtask at any time

</details>

## Milestone Target Dates

***

Each Milestone can be assigned a Target Date: the original or ideal date you’re aiming for, often pulled from a Master or Contract Schedule. The Target Date marker changes colour based on performance, helping you see at a glance how things are progressing against the plan.

#### **To set a Target Date:**

* Right click a Milestone and select `View Details`
* In the Task Panel that opens, locate the `Target Date` section
* Toggle  <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FrvTcctNRDtoOHaw7U9zU%2FTheme%3DLight%2C%20Size%3DRegular%2C%20State%3DOn.svg?alt=media&#x26;token=d08029bc-cd20-4401-bc69-8ded58cdca38" alt="" data-size="line"> `Set Target Date`
* Pick the date

#### **To See Target Date Variance on the Gantt:**

* If your Milestone has slipped the Target Date marker will appear as <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FnRvmcVIG0LgC1JQpKw4F%2FFrame%203275.svg?alt=media&#x26;token=e6ebe564-e5fe-4168-b990-a5dde96b7962" alt="" data-size="line">
* If your Milestone is on track, Target Date marker will appear as ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FAHn9ZIJdUROV9bPXC0ru%2FFrame%203275%20\(1\).svg?alt=media\&token=93489ac9-6a49-4b53-aa0a-e836f54528df)
* Use the `+`/`-` indicators to see how many days a Milestone is ahead or behind

<details>

<summary>Target Date Logic </summary>

* Target Dates will show green if:
  * The Milestone End Date matches the Target Date
  * The Milestone End Date is before the Target Date
* Target Dates will show red if:
  * The Milestone End Date is after the Target Date
* On the Gantt, a Variance Number will show how many days the Milestone has slipped or improved by
* Target Date Icons & Variance update in real time as changes are made to the plan

</details>

## Tracking Milestone Performance

***

Use the Milestone Panel to compare current Milestone Dates to Target Dates, or pervious Weekly Versions to see how things have shifted over time - and spot the impact of today's changes on future Milestones, even if they're outside of your View.&#x20;

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fn6Yxz35em8nbIsrSVeWJ%2FMilestone%20Panel.svg?alt=media&#x26;token=178e770a-4ae3-4ba7-8853-1fa74ccb936b" alt=""><figcaption></figcaption></figure>

#### Open the Milestone Panel:

* On the Gantt, select the ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FqKNMvhxEzQ4JAskC9dFB%2FMilestone%20Icon%20\(2\).svg?alt=media\&token=54f100b0-047d-48f3-b301-36be5e1e81bd) Milestone Icon in the right-hand panel
* This opens the `Milestone Panel`, showing Milestones across the Project
* Click the `⌄` next to any Milestone to expand its history and see how it’s changed over time
  * Open the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FMHITYZSRXlaIXMvqrJZu%2FIcon%20Buttons%20(4).svg?alt=media&#x26;token=ac847fe0-006b-4ff0-b70a-8758c4ca625d" alt="" data-size="line"> config menu to toggle filters for delayed or improved Milestones

#### Target Date Comparison:

* In the Milestones Panel, click into the `Compare To` dropdown
* Select `Target Date`
* Instantly see how many days ahead/behind for each Milestone, compared to their Target Dates

#### Baseline Comparison:

* In the Milestones Panel, click into the `Compare To` dropdown
* Select `Previously Published Version`
* Instantly view the variance between current and baseline dates

See also: <a href="../imports-and-exports#exporting-milestones" class="button secondary">Export Milestone Data</a>

<details>

<summary>Configuring the Milestone Panel</summary>

**Date Range:** Controls which Milestones appear in the list. You can show only those within your current Gantt view, all future Milestones, or every Milestone in the project.\
\
**Group By:** Organises your Milestones into sections. Choosing Performance vs Target splits them into four groups based on how the Milestone's end date compares to its Target Date:

* **Approaching Target**: the end date is before the Target Date
* **On Target**: the end date matches the Target Date exactly
* **Behind Target**: the end date has passed the Target Date
* **No Target**: no Target Date has been set

You can also group by Owner, Subcontractor, Folder, or Package.\
\
**Sort By**: Controls the order Milestones appear within each group. Sort by date or variance, in ascending or descending order.\
\
**Spotlight Milestones with Variance**: When toggled on, this highlights Milestones that have slipped or improved. You can choose to spotlight just slippage, just improvements, or both.\
\
Your configuration is saved automatically per user, so the panel will remember your preferences next time.

</details>

## Critical Path Overlay

***

Turn on the Critical Path Overlay to highlight the short term path to any Milestone. The critical path will light up in gold, and everything else fades to blue - so it's easy to see what's critical and what's not. You can view paths for all Milestones or focus on one at a time.

**To turn on the Critical Path**

* Open the Gantt and click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FrG483tQu3ZGYIlP5D1Lq%2FView%20Sub%20Nav%20Buttons%20(6).svg?alt=media&#x26;token=e9e3bccb-b93e-43ec-b54d-3f3bc509f5f3" alt="" data-size="line">
* Select `Critical Path` to highlight all Milestone paths in gold
* Or click the `>` to choose specific Milestone pathways to highlight individually

## Filter to Milestones

***

#### To set a Milestone filter:

* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F1uSzhSb5aSNnZd5vTaGB%2FFilter%20Button.svg?alt=media&#x26;token=8ddd7f1c-0296-4af2-bdeb-d08d56fc56b6" alt="" data-size="line"> and <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FbVv9qtyepRHQfkVwypud%2FText%20Buttons%20(2).svg?alt=media&#x26;token=fce29edb-8b74-4d75-bfa0-d8ad7292c94b" alt="" data-size="line">
* Select `Milestone` in the first dropdown
* Select from `Is True` or `Is False` in the second dropdown

#### Pre-made Milestones View:

Your Project comes with a pre-made Upcoming Milestones View.

* Click `+ Views` within the open View Tabs
* Select `Upcoming Milestones View`

See also: creating & sharing <a href="view-controls" class="button secondary">Views</a>

<details>

<summary>Filter Breakdown</summary>

| Filter     | Operator                   | Value        |
| ---------- | -------------------------- | ------------ |
| Milestones | <p>Is True<br>Is False</p> | Multi-Select |

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.aphex.co/docs/planner/features/milestones.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
