Skip to main content

What You Will Achieve

After completing this tutorial, you will have:
  • A Plans Gantt widget showing Polarion Plans as top-level task bars
  • Nested sub-plans displayed beneath parent plans
  • Work items shown within their parent plans
  • A multi-level Gantt view suitable for release and iteration planning

Prerequisites

  • Gantt installed on your Polarion server
  • A Polarion project with existing Plans (releases, iterations, or sprints)
  • Edit permissions on the project’s Documents & Pages
The Plans Gantt widget uses a different data model than the Work Items Gantt. Plans are Polarion’s built-in planning containers (releases, iterations, sprints). If you need to schedule individual tasks, use the Work Items Gantt instead.
1

Create an Info/LiveReport Page

  1. Open your Polarion project
  2. Navigate to Documents & Pages
  3. Select a space (for example, Default Space)
  4. Click Expand Tools, then the Gear button, and select Create New
  5. Choose Info/LiveReport Page and enter a title (for example, “Release Roadmap”)
  6. Click Create
You should see an empty page ready for widget configuration.
2

Add the Plans Gantt Widget

In the widget picker on the right side of the page:
  1. Expand the Plans category
  2. Select Gantt (Plans)
  3. The widget loads, displaying plans from your project
Roadmap report with the project navigation on the left and Releases, Iterations, and work items rendered as nested Gantt bars on the right
The Plans Gantt widget appears under a different category than the Work Items Gantt. Make sure you select Gantt (Plans) from the Plans section.
3

Configure the Plans Data Set

  1. Open the widget parameters
  2. In the Plans data set section, configure the scope to show plans with a specific template (for example, Release)
  3. Click Apply
Widget parameters with Type set to Plan and a Query entry reading Template: Release
You should see only plans matching the selected template displayed as task bars on the Gantt chart.
4

Load Sub-Plans

To display child plans (for example, iterations beneath releases):
  1. In the widget parameters, set Load Children to 2 to load two levels of plan hierarchy
  2. Click Apply
Load Children parameter field set to the value 2
You should see a hierarchy like:
diagram
5

Show Work Items Within Plans

To display the actual work items contained in each plan:
  1. In the widget parameters, find the Show Plan Work Item section
  2. Set Enable Show Items to Yes
  3. Configure the field mappings for the work items:
    • Start Field: the work item field holding the start date
    • End Field: the work item field holding the end date
    • Duration Field: the work item field holding duration
Show Plan Work Item section with Enable Show Items set to Yes and Start, Duration, and Progress fields mapped to start, initialEstimate, and gantt_progress
  1. Set the Parent Role to define how work item hierarchy is resolved within plans
  2. Click Apply
Show Plan Work Item section with the Parent Role field set to implements to resolve work item hierarchy within plans
You should now see work items displayed as task bars beneath their parent plan bars.
Plans Gantt with Version 2.0, Iterations, and individual DP work items expanded in the left tree and rendered as nested bars with Verified statuses
Plans Gantt charts typically use longer time scales. Set the Scale parameter to W (week) or M (month) for a better overview of release timelines.
6

Configure Work Item Dependency Links

If your work items have dependency relationships with work items:
  1. In the Show Plan Work Item section, find Dependency Role
  2. Select the link role used for dependencies (for example, depends_on)
  3. Click Apply
Dependency arrows now appear between work items within the Plans Gantt view.
7

Adjust Display Options

Fine-tune the Plans Gantt view:
  1. Set Sort by to control the order of plans (default is id)
  2. Set Show Unplanned to Yes if you want to see plans without dates (they appear at today’s date in gray)
  3. Enable Maximize View in the Advanced section for full-page display
  4. Click Apply and save the page
Work item creation from within Plans Gantt may be limited to the lowest plan level. If you need to create work items at multiple plan levels, consider using separate Gantt widgets for each level.

Plans Gantt Parameter Summary

Next Steps

Last modified on July 10, 2026