Last reviewed on {formatted}
; }; ## Per-Type Configuration Parameters Each work item type added to the **Work Item Types** configuration block exposes the following sub-parameters: | Name | Type | Default | Description | | -------------------------- | ---------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Gantt Presentation Mode` | Enum | See application | Controls how the type renders on the chart: `Item` (a regular task bar), `Derived Schedule` (a summary bar whose schedule comes from children), `Auto-Mode` (`Derived` if the item has children, else `Item`), or `Milestone` (a single-date diamond with zero duration). | | `Parent Mode` | Enum | See application | Determines how parent-child hierarchy is resolved for this type. Options include link-role-based or enumeration-based parent resolution. | | `Parent Enum` | String | See application | When `Parent Mode` uses enumeration-based resolution, specifies the enum field to determine the parent work item. | | `Additional Dialog Fields` | Field list | Empty | Extra work item fields displayed in the lightbox editor for this type, beyond the standard start/end/duration/progress fields. | | `Sync to Plans` | Boolean | `false` | When enabled, links work items of this type to a Polarion Plan and adds plan due date markers to the chart. | | `Enable Create` | Boolean | `false` | When enabled, this type appears in the **New** toolbar dropdown, allowing users to create work items of this type directly from the Gantt chart. | | `Extra Child Query` | String | Empty | A Lucene query that loads additional child items for this type beyond the standard parent-child link traversal. | The dynamic "presentation depends on whether the item has children" behaviour is provided by the **`Auto-Mode`** value of `Gantt Presentation Mode` (it is not a separate boolean parameter).
**Item** -- Rendered as a standard task bar with start date, end date, and duration. The bar is directly editable by dragging.
**Derived Schedule** -- Rendered as a summary bar whose schedule is derived from its child items. You cannot directly drag the start or end date of a derived-schedule item; it auto-calculates from children.
**Auto-Mode** -- Renders as **Derived Schedule** when the item has children, otherwise as **Item**. Use it for a type that can be either a parent or a leaf.
**Milestone** -- Rendered as a diamond shape at a single point in time. Milestones have no duration.
## Collapse Behavior via Item Script
You can control the initial collapsed state of parent work items per type using the [Item Script API](/gantt/reference/api/item-script-api):
```javascript theme={null}
// Collapse all workpackage-type items by default
if (wi.getType().getId() === "workPackage") {
task.open = false;
}
```
This sets the `task.open` property to `false`, causing the item to appear collapsed when the Gantt chart loads.
## Work Items Gantt vs. Plans Gantt
The per-type configuration applies differently depending on the Gantt mode:
| Aspect | Work Items Gantt | Plans Gantt |
| ------------------------ | -------------------------------------------- | ---------------------------------- |
| Type source | Polarion work item type ID | Plan template type |
| Presentation modes | Item, Derived Schedule, Auto-Mode, Milestone | Derived Schedule, Milestone |
| Enable Create | Creates a new work item | Creates a new plan from a template |
| Parent resolution | Link roles or enumeration | Plan hierarchy |
| Additional Dialog Fields | Work item custom fields | Plan-level fields |
For Plans Gantt configuration, see [Plans Gantt Widget Parameters](/gantt/reference/widget-parameters/plans-gantt).
## Configuration Example
To configure an `epic` type as a project container and a `release` type as a milestone:
1. Open **Widget Properties** for the Gantt widget.
2. In the **Work Item Types** section, add an entry for `epic`:
* Set **Gantt Presentation Mode** to `Derived Schedule`
* Set **Enable Create** to `Yes` if you want users to create epics from the toolbar
3. Add another entry for `release`:
* Set **Gantt Presentation Mode** to `Milestone`
4. Save the widget parameters.