> For the complete documentation index, see [llms.txt](https://docs.appfarm.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appfarm.io/library/ui-components/advanced-gantt-chart.md).

# Advanced gantt chart

The Advanced Gantt Chart displays a schedule with start and finish dates of a project's elements, such as resources, planning, and dependencies.

## Usage

Advanced Gantt Charts are used to show project schedules or similar, for example resource planning diagrams. Dates are shown in the [App Time Zone](https://docs.appfarm.io/reference/platform-concepts/date-and-time.md#default-behavior).

{% hint style="info" %}
Showroom: [Advanced Gantt Chart example](https://showroom.appfarm.app/ui-components/gantt), with its setup in Appfarm Create ([register](https://showroom.appfarm.app/sign-up) for access).
{% endhint %}

## Properties

| Property                | Description                                                                                                                                                                                                                                                                                                            |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Data source**         | Select the primary data source to display in the chart. Within the project context this would be the task object.                                                                                                                                                                                                      |
| **Filter**              | Apply a filter to the selected data source.                                                                                                                                                                                                                                                                            |
| **Conditional filters** | Create conditional filters to apply to the selected data source.                                                                                                                                                                                                                                                       |
| **Sorting**             | Define the sorting order of the selected data sources by adding one or more sorting properties.                                                                                                                                                                                                                        |
| **Dynamic sorting**     | <p>Visible when <strong>Sorting</strong> has at least one entry.</p><p>Enable to sort the rows again when an item is moved. The chart redraws once when a row moves.</p>                                                                                                                                               |
| **Display value**       | Define the display value (subtitles of each gant line) by binding it to a data source. Within the project context this would be the project name/title connected to the task. If not set, the default property for display value on the object class will be used.                                                     |
| **Start date**          | Select a data source to display the start date.                                                                                                                                                                                                                                                                        |
| **End date**            | Select a data source to display the end date.                                                                                                                                                                                                                                                                          |
| **Parent item**         | If there is a structure with main tasks and subtasks, select a data source to display the parent item.                                                                                                                                                                                                                 |
| **Is milestone**        | Select a data source of data type boolean to display a milestone in the chart.                                                                                                                                                                                                                                         |
| **Progress**            | Select a property of data type Float to display the progress of each task.                                                                                                                                                                                                                                             |
| **Is movable**          | <p>Select a data source of data type boolean or set a static value true to allow moving the item on the X Axis.</p><p>When an item is dragged, its new start and end dates are written to the object. In a database-connected data source the change is saved to the database right away.</p>                          |
| **Start date movable**  | Select a data source of data type boolean or set a static value true to allow moving the start date of the item.                                                                                                                                                                                                       |
| **End date movable**    | Select a data source of data type boolean or set a static value true to allow moving the end date of the item.                                                                                                                                                                                                         |
| **Min movable date**    | Optionally select a date value: the earliest date the item can be moved to.                                                                                                                                                                                                                                            |
| **Max movable date**    | Optionally select a date value: the latest date the item can be moved to.                                                                                                                                                                                                                                              |
| **Move between groups** | <p>Read-only unless <strong>Same line</strong> is enabled.</p><p>Select a data source of data type boolean or set a static value true to allow dragging items to other groups.</p>                                                                                                                                     |
| **Fill color**          | Select a data source to use the colors from Enum Values.                                                                                                                                                                                                                                                               |
| **Dependency type**     | Select between the three dependency types Parent Dependency, Dependant Child and Multi Dependencies.                                                                                                                                                                                                                   |
| **Parent dependency**   | <p>Visible when <strong>Parent Dependency</strong> is selected.</p><p>Select a data source to indicate which item must be completed before this item can start.</p>                                                                                                                                                    |
| **Dependent child**     | <p>Visible when <strong>Dependant Child</strong> is selected.</p><p>Select a data source to indicate which items depend on this item. May be used when a single child can have multiple parents.</p>                                                                                                                   |
| **Dependencies**        | <p>Visible when <strong>Multi Dependencies</strong> is selected.</p><p>Select a data source to indicate the relations between items.</p>                                                                                                                                                                               |
| **Parent**              | <p>Visible when <strong>Multi Dependencies</strong> is selected.</p><p>Select the data source which contains the parent item.</p>                                                                                                                                                                                      |
| **Child**               | <p>Visible when <strong>Multi Dependencies</strong> is selected.</p><p>Select the data source which contains the child item.</p>                                                                                                                                                                                       |
| **Grouping property**   | Select a property of data type Enum or Reference to group the data on. Within the project context this would be the project in the task object.                                                                                                                                                                        |
| **Groups**              | <p>Visible when the <strong>Grouping property</strong> is a reference.</p><p>Select a data source to group the data on. Within the project context this would be the project object.</p>                                                                                                                               |
| **Group label**         | <p>Visible when <strong>Grouping property</strong> is selected.</p><p>Select a data source to override the display value. If not set, the naming property of the <strong>Groups</strong> data source will be used by default.</p>                                                                                      |
| **Hide empty**          | <p>Visible when <strong>Grouping property</strong> is selected.</p><p>Enable to hide groups without content.</p>                                                                                                                                                                                                       |
| **Hide summary**        | <p>Visible when <strong>Grouping property</strong> is selected and <strong>Same line</strong> is disabled.</p><p>Enable to hide the group summary block.</p>                                                                                                                                                           |
| **Same line**           | <p>Visible when <strong>Grouping property</strong> is selected.</p><p>Enable to display all items of every group on the same line. For example are there lines with projects and the tasks are displayed as named blocks on the same line as the project. May be used when creating a resource management diagram.</p> |
| **Title**               | Enter a static title or bind it to a data source, function, date now or date today.                                                                                                                                                                                                                                    |
| **Subtitle**            | Enter a static title or bind it to a data source, function, date now or date today.                                                                                                                                                                                                                                    |
| **Drag Precision**      | Define the step size in hours used when editing the items by drag and drop. Default is 24.                                                                                                                                                                                                                             |
| **Color gradient**      | Enable to add a small gradient to the colors in the chart.                                                                                                                                                                                                                                                             |
| **Default color**       | Define a default color for the case that when binding colors to data and the colors for some reason cannot be found.                                                                                                                                                                                                   |
| **Sticky header**       | <p>Enable to stick the header to the top when scrolling down the chart. If enabled, the navigator will also be sticky as well.</p><p>The header needs a solid background color to stay on top when scrolling. Set it in <strong>Background color</strong>.</p>                                                         |
| **Background color**    | <p>Visible when <strong>Sticky header</strong> is enabled.</p><p>Select a background color for the chart.</p>                                                                                                                                                                                                          |
| **Today line**          | Enable to display the current date with a slight line through all rows.                                                                                                                                                                                                                                                |
| **Min date**            | Select the minimum date for the time scale. If not set, it will adjust to the available data from the data source.                                                                                                                                                                                                     |
| **Max date**            | Select the maximum date for the time scale. If not set, it will adjust to the available data from the data source.                                                                                                                                                                                                     |
| **Navigator**           | Enable to display a navigator on the X Axis of the chart.                                                                                                                                                                                                                                                              |
| **Minimum range**       | <p>Visible if <strong>Navigator</strong> is enabled.</p><p>Define the minimum window in hours when zooming in. By default, one week (168 hours) is used.</p>                                                                                                                                                           |
| **Maximum range**       | <p>Visible if <strong>Navigator</strong> is enabled.</p><p>Define the maximum window in hours when zooming out. By default, all data is shown.</p>                                                                                                                                                                     |
| **Event handlers**      | <p><strong>On item click</strong> runs when an item is clicked.</p><p><strong>On item changed</strong> runs after an item is changed by drag and drop.</p>                                                                                                                                                             |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.appfarm.io/library/ui-components/advanced-gantt-chart.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
