Skip to main content

Single Widget Per Page

Only one Gantt widget is supported on a single Polarion report page. Placing a second widget on the same page is not supported due to the resource-intensive nature of the Gantt chart rendering engine.
Adding more than one Gantt widget to the same report page causes conflicts and is not supported. The chart requires exclusive control of the page layout, event handlers, and data processing pipeline.

Workaround Strategies

Use one of the following approaches to view different Gantt data sets without placing multiple widgets on the same page.

Option 1: Use Separate Documents

Create dedicated Polarion LiveDoc or Wiki pages for each Gantt view you need. For example:
PagePurposeQuery
Release-Planning-GanttRelease-level schedulingWork items in current release plan
Team-GanttTeam workload viewWork items assigned to a specific team
Sprint-GanttSprint-level detailWork items in the active sprint
Each page hosts its own Gantt widget with independent widget parameters, query configuration, and scale settings. You can navigate between them using Polarion page links.

Option 2: Use Dynamic Queries with Page Parameters

Instead of creating separate pages for each data set, configure a single Gantt page with page parameters that dynamically change the displayed data. This approach lets you switch between different views on the same page by changing parameter values.
  1. Open your Gantt page in Edit mode.
  2. Configure the widget query type to Lucene + Velocity.
  3. Use page parameters in the query to filter work items dynamically:
    type:task AND assignee.id:($pageParameters.team.toLucene())
    
  4. Add a page parameter control so users can select different teams or plan levels from a dropdown.
Page parameters effectively replace the need for multiple widgets. A single page with a team or plan-level parameter dropdown lets users switch views instantly without navigating away. See Use Dynamic Queries with Page Parameters for full configuration steps.

Option 3: Use Plans Gantt for Multi-Level Views

If your goal is to see work items across multiple plan levels, the Plans Gantt widget can display plans and their work items together in a single hierarchical view. Configure the Show Plan Work Item section to display work items beneath each plan bar. See Show Plans and Work Items Together for setup instructions, or Configure Multiple Plan Levels to display nested plan hierarchies.

Choosing the Right Approach

diagram

Verification

After applying your chosen workaround, you should now see:
  • Separate pages: Each page loads its own Gantt widget independently with the correct query results.
  • Page parameters: Changing the parameter dropdown reloads the Gantt with the filtered data set.
  • Plans Gantt: Plans appear as parent bars with work items nested beneath them.

See Also

KB ArticlesSupport TicketsSource Code
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/main.js
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/widget/GanttWidget.java
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/working-calendars/workcalendar-toggles.cy.ts
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/columns/Table.java
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/widget/GanttWidgetConfig.java