Skip to main content

​
Prerequisites

  • A Gantt widget placed on a Polarion LiveDoc or Wiki page
  • Permission to edit widget parameters

​
Choose a Display Mode

The Gantt supports three display modes depending on how you want the widget to appear on the page:
ModeConfigurationBehavior
Embedded (default)No maximize or height setWidget renders at its natural size within the page layout
Fixed heightSet the height widget parameter (pixels)Widget renders at a specific pixel height, ignoring viewport size
MaximizeSet maximize = trueWidget expands to fill the entire browser viewport
diagram

​
Enable Maximize Mode

  1. Open the Polarion page containing the Gantt widget
  2. Edit the widget properties
  3. Navigate to Advanced > Maximize and set it to Yes
  4. Save the page
The widget now fills the full working area of the Polarion page. The Gantt chart occupies the entire viewport, with the toolbar at the top providing access to all controls.
When using maximize mode, ensure there are no additional empty paragraphs or other whitespace content above or below the Gantt widget on the page. Extra whitespace can cause layout issues that prevent the widget from properly filling the viewport.

​
Set a Fixed Height

If you want the Gantt to occupy a specific area on the page alongside other content:
  1. Edit the widget properties
  2. Set the height widget parameter to a pixel value (for example, 600)
  3. Leave maximize turned off
This is useful when embedding the Gantt in a page that contains other widgets or text content above and below.

​
Features Unlocked by Maximize Mode

Enabling maximize mode provides access to features that are not available in embedded mode:
  • Page Parameters button ⚙️ — The tb_parameters toolbar button only appears when the Gantt is in maximized view. This button opens the Page Parameters panel, allowing users to modify query filters and other parameters without editing the page.
  • Session keep-alive — The Gantt starts a polling loop that keeps the Polarion session active while the chart is open, preventing session timeout during long planning sessions.
  • Viewport-responsive resizing — The Gantt automatically adjusts its height when the browser window is resized to continue filling the full viewport.
Create a single LiveDoc page (for example, named “Gantt”) with only the Work Items Gantt widget. Set maximize = true to make the widget fill the entire working area. This provides the best user experience for daily schedule management.

​
Combine Maximize with Page Parameters

When you need both maximize mode and dynamic page parameters (for example, letting users select a version number to filter work items):
  1. Add a Page Parameters widget to the page
  2. Add the Gantt widget to the page — keep maximize turned OFF initially
  3. Add your page parameters and reference them in the Gantt query
  4. Test the page to confirm filtering works correctly
  5. Now enable Advanced > Maximize on the Gantt widget
After enabling maximize, the ⚙️ Settings button appears in the Gantt toolbar. Users click this button to open the Page Parameters panel and change filter values without leaving the maximized view.
You can also read page parameter values programmatically in an Item Script using:
config.getPageParameters().get("pageParamId")
Replace pageParamId with the ID of your page parameter.

​
Verify Your Configuration

  1. Open the Polarion page containing the Gantt widget
  2. You should now see the Gantt chart filling the entire browser viewport
  3. The toolbar appears at the top with all configured buttons
  4. If you configured page parameters, the ⚙️ Settings button should be visible in the toolbar
  5. Resize the browser window — the Gantt should adjust its height automatically

​
See Also

KB ArticlesSource Code
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/fullscreen.js
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/index.js
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/config.js
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/maximize.js
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/gantt.js