Skip to main content

What You Will Achieve

After completing this tutorial, you will have:
  • A Polarion Info Page with a Work Items Gantt widget
  • Filtered work items displayed as task bars on the Gantt chart
  • Parent-child hierarchy showing grouped work items
  • Dependency roles configured for linking tasks

Prerequisites

  • Nextedy GANTT installed on your Polarion server
  • A Polarion project with existing work items (or use the E-Library template)
  • Edit permissions on the project’s Documents & Pages
If you are evaluating Nextedy GANTT, consider starting with the demo project first. It provides a pre-configured Gantt chart you can explore immediately.

Step 1: Create an Info Page

  1. Open your Polarion project
  2. Navigate to Documents & Pages
  3. Select a space (for example, Default Space)
  4. Click Expand Tools in the upper toolbar
  5. Click the Gear button and select Create New
  6. Choose Info Page
  7. Enter a title (for example, “Project Gantt”) and click Create
You should see an empty Info Page with the widget picker available on the right side.

Step 2: Add the Work Items Gantt Widget

In the widget picker on the right side of the page:
  1. Expand the Work Items category
  2. Select Gantt (Work Items)
  3. The widget loads onto your page, displaying all work items in the project
Polarion shows two Gantt widgets: Gantt (Work Items) under the Work Items category displays individual work items. Gantt (Plans) under the Plans category displays Polarion Plans. For this tutorial, use the Work Items variant.

Step 3: Filter Work Items by Type

By default, the Gantt loads all work items in the project. To show specific types:
  1. Open the widget parameters (click the Edit button on the page, then the widget gear icon)
  2. In the Query section, click the + button to add a filter
  3. Select Type from the filter options
  4. Choose the work item types you want to display (for example, Epic and Release)
  5. Click Apply
You should see only the selected work item types displayed as task bars on the Gantt chart.

Step 4: Enable Maximize View

To use the Gantt chart in full-page mode:
  1. In the widget parameters, scroll to the Advanced section
  2. Set Maximize Gantt View to Yes
  3. Click Apply
The Gantt chart now fills the entire page area, giving you maximum working space.

Step 5: Configure Parent-Child Hierarchy

The hierarchy of items on the Gantt chart is derived from work item link roles.
  1. In the widget parameters, find Parent Role
  2. Click Select and add the relevant link role (for example, has_parent) from the left list to the right
  3. Set Load Children to 1 to display one level of child items
  4. Click Apply
You should see child work items nested beneath their parents in the Gantt chart. If you need deeper hierarchy (for example, Epic > User Story > Task), increase Load Children to 2 and add additional parent roles (for example, implements).
Load ChildrenResult
0Only top-level items, no hierarchy
1One level of children (e.g., Epic > User Story)
2Two levels (e.g., Epic > User Story > Task)
Dependency links are derived from work item link roles, just like parent-child relationships.
  1. In the widget parameters, find Dependency Role
  2. Click Select and add the dependency link role (for example, depends_on)
  3. Click Apply
You should see dependency arrows drawn between linked work items on the Gantt chart. The first selected dependency role is used when creating new dependency links by dragging between task bars. diagram

Step 7: Save the Page

Click the Save button on the Polarion page toolbar to persist your widget configuration.
Widget parameter changes require saving the page in Edit mode. If you navigate away without saving, your configuration changes are lost.

Key Widget Parameters Summary

ParameterPurposeExample Value
Query / TypeFilter which work items appearEpic, Release
Parent RoleDefine parent-child hierarchyhas_parent
Load ChildrenDepth of child loading1 or 2
Dependency RoleDefine dependency relationshipsdepends_on
Maximize Gantt ViewFull-page displayYes

Next Steps

KB ArticlesSupport TicketsSource Code
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/index.js
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/index.html
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/main.js
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/Aresource-view/ItemsWithDoubleSpaceInTitleAreVisible.cy.ts
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/config.js