> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nextedy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Fullscreen and Maximize Mode

> This guide shows you how to expand the Nextedy GANTT widget to fill the full browser viewport for an immersive planning experience.

export const LastReviewed = ({date}) => {
  if (!date) return null;
  const formatted = new Date(`${date}T00:00:00Z`).toLocaleDateString("en-US", {
    year: "numeric",
    month: "long",
    day: "numeric",
    timeZone: "UTC"
  });
  return <p className="mt-10 text-sm text-gray-400 dark:text-zinc-500 not-prose">
      Last reviewed on {formatted}
    </p>;
};

## 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:

| Mode                   | Configuration                              | Behavior                                                          |
| ---------------------- | ------------------------------------------ | ----------------------------------------------------------------- |
| **Embedded (default)** | No `maximize` or `height` set              | Widget renders at its natural size within the page layout         |
| **Fixed height**       | Set the `height` widget parameter (pixels) | Widget renders at a specific pixel height, ignoring viewport size |
| **Maximize**           | Set `maximize = true`                      | Widget expands to fill the entire browser viewport                |

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/DDjWgCW2DWY5biNv/gantt/diagrams/guides/layout/fullscreen-mode/diagram-1.svg?fit=max&auto=format&n=DDjWgCW2DWY5biNv&q=85&s=638e607a22ed5700ba774edd8551bc3d" alt="diagram" style={{ maxWidth: "600px", width: "100%" }} width="600" height="460" data-path="gantt/diagrams/guides/layout/fullscreen-mode/diagram-1.svg" />
</Frame>

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

<Warning title="Remove empty paragraphs around the widget">
  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.
</Warning>

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

<Tip title="Recommended setup for dedicated Gantt pages">
  Create a single LiveDoc page (for example, named "Nextedy 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.
</Tip>

## 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 ⚙️ **Page Parameters** 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.

<Note title="Access page parameters from Item Script">
  You can also read page parameter values programmatically in an Item Script using:

  ```javascript theme={null}
  config.getPageParameters().get("pageParamId")
  ```

  Replace `pageParamId` with the ID of your page parameter.
</Note>

## 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 ⚙️ Page Parameters button should be visible in the toolbar
5. Resize the browser window -- the Gantt should adjust its height automatically

## See Also

* [Configure Page Parameters](/gantt/guides/layout/page-parameters) for detailed page parameter setup
* [Configure the Toolbar and Menus](/gantt/guides/layout/toolbar-configuration) for toolbar button visibility
* [Use Multiple Gantt Widgets](/gantt/guides/layout/multiple-widgets) for pages with multiple Gantt instances
* [Print and Export to PNG](/gantt/guides/layout/print-and-export) for exporting the maximized view

<LastReviewed date="2026-07-07" />