Work Item Types Configuration - Nextedy Documentation

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).

Fields already bound as Start Field, End Field, Duration Field, or Progress Field in the Data Mapping Parameters cannot be added to Additional Dialog Fields. The system validates this at load time and logs a warning for invalid field references.

Default Work Item Types

The Gantt chart ships with three built-in work item type configurations:

Type ID	Gantt Presentation Mode	Description
`feature`	Item	Standard task bars displayed as individual bars on the chart.
`workpackage`	Derived Schedule	Parent containers displayed as summary bars whose schedule is derived from child items.
`release`	Milestone	Milestone-style containers rendered as diamond shapes with no duration.

The default types serve as a starting reference. Override them in the widget parameter editor to match your project’s work item type IDs (e.g., epic, story, task).

Presentation Modes

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:

// 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.

Configuration Example

To configure an epic type as a project container and a release type as a milestone:

Open Widget Properties for the Gantt widget.
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
Add another entry for release:
- Set Gantt Presentation Mode to Milestone
Save the widget parameters.

Setting a type as Project or Milestone does not add or remove items from the Gantt view. It only changes how items of that type are rendered. The visible items are determined by the Work Items data set parameter in Work Items Gantt Widget Parameters.

Work Items Gantt Widget Parameters — main widget parameter reference
Plans Gantt Widget Parameters — plan-type configuration
Data Mapping Parameters — field binding for start, end, duration, progress
Item Script API — scripting for per-item behavior customization

​Per-Type Configuration Parameters

​Default Work Item Types

​Presentation Modes

​Collapse Behavior via Item Script

​Work Items Gantt vs. Plans Gantt

​Configuration Example

​Related Pages

Per-Type Configuration Parameters

Default Work Item Types

Presentation Modes

Collapse Behavior via Item Script

Work Items Gantt vs. Plans Gantt

Configuration Example

Related Pages