# Milestones

Milestones in the Gantt time that help to establish mark the specific key points within the timeline. 

![Image 1: Milestones in Gantt Chart](https://382510089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIuuIZWiXEx25eV75hmmJ%2Fuploads%2FU7L8a9Iwosins0AGwnS0%2F0.png?alt=media)

Milestones serve multiple purposes, including tracking and monitoring progress, establishing goals and objectives, identifying potential delays, and communicating progress to stakeholders.

### **Steps to Configure the Milestones:**

![GIF 1: Setting up Milestones](https://382510089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIuuIZWiXEx25eV75hmmJ%2Fuploads%2F3PMyHo94d8i9VGtoCjOU%2F1.gif?alt=media)

#### Type 1 – Multiple Milestone Date columns

1. Here's an example of a data with 3 columns for Milestone dates

![Image 2: Data Structure for Milestone](https://382510089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIuuIZWiXEx25eV75hmmJ%2Fuploads%2F8AI0mbHjWX5FDJwMZFSp%2F2.png?alt=media)

2. Add the date columns to the **Milestone** **data field**

![Image 3: Data field to configure Milestones.](https://382510089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIuuIZWiXEx25eV75hmmJ%2Fuploads%2FQNOAqFdQblpw9gQTRDut%2F3.png?alt=media)

3. As a result, the three milestones are plotted for every site (leaf level bars)

![Image 4: Multiple Milestones on a bar](https://382510089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIuuIZWiXEx25eV75hmmJ%2Fuploads%2FOqqKIF7TbMJzIJOTHKYD%2F4.png?alt=media)

#### Type 2 - Date and Milestone Name columns

1. Here's an example of a data with a column for milestone dates and another for the milestone names.

![Image 5: Data Structure with Milestone and Milestone Name](https://382510089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIuuIZWiXEx25eV75hmmJ%2Fuploads%2FiXM4xiV35RDJes4OnvH4%2F5.png?alt=media)

2. Add the data to the **Milestone** and **Milestone Name data fields**

![Image 6: Data field to configure Milestones
and Milestone Name](https://382510089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIuuIZWiXEx25eV75hmmJ%2Fuploads%2FkDJ8F7gf1s0n0yeD0mzU%2F6.png?alt=media)

3. As a result, the different types of milestones are plotted on the Sites/bars

![Image 7: The output of Milestone Name](https://382510089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIuuIZWiXEx25eV75hmmJ%2Fuploads%2FxaqQTKR334RLchQQ1y77%2F7.png?alt=media)

{% hint style="success" %}
Please refer to the documentation link below for details on milestone formatting, which allows you to customize the shape, color, and image of each milestone - [milestone-formatting](https://docs.xviz.com/project-management/milestones/milestone-formatting "mention")
{% endhint %}

#### Type 3 - Milestones from Data

1. A Milestone from Data is created when the start date and end date are the same.

<figure><img src="https://382510089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIuuIZWiXEx25eV75hmmJ%2Fuploads%2FSTYL4LQWsV1q5l9VHarW%2Fimage.png?alt=media&#x26;token=febd1f7e-3192-4fbd-b575-fc0fb3def121" alt=""><figcaption><p><em>Image 8: Data Structure from Milestones from Data</em></p></figcaption></figure>

2. To Display Milestone from Data, navigate to the Milestone tab of the Advanced Editor, turn on “Allow Milestone from Data.”

<figure><img src="https://382510089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIuuIZWiXEx25eV75hmmJ%2Fuploads%2FwfQR5oGFxVkZ3Kce8VtB%2Fimage.png?alt=media&#x26;token=e69fc736-ae32-4d19-b2e5-6dcf84b82e4b" alt=""><figcaption><p><em>Image 9: Allow Milestone from Data</em></p></figcaption></figure>

{% hint style="warning" %}
"Allow Milestone from Data" is visible only when the milestone field is populated with a milestone column
{% endhint %}

As a result, Milestones from data will appear in the Gantt chart as shown in the image below:

<figure><img src="https://382510089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIuuIZWiXEx25eV75hmmJ%2Fuploads%2FX5jrotCm6SD70ZUdRSNY%2Fimage.png?alt=media&#x26;token=a83b61a8-288c-4f32-b248-5eb8f43fcb6c" alt=""><figcaption><p><em>Image 10: Milestone from Data in the Gantt Chart</em></p></figcaption></figure>

{% hint style="warning" %}
If the "Allow Milestone from Data" toggle is off, tasks where start = end date will be hidden.
{% endhint %}


---

# 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://docs.xviz.com/project-management/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.