Skip to main content

​
Table Widget Parameters

NameTypeDefaultDescription
WIDTHIntegerSee applicationThe total width of the grid panel (left side of the Gantt chart) in pixels. This controls the split point between the grid and the timeline area.

​
First Column Configuration

The first column always appears in the grid and displays the task label. The FIRST_COL configuration block controls what information is shown in this column:
NameTypeDefaultDescription
FIRST_COL.showIdBooleanSee applicationWhen true, the first column displays the work item ID prefix (e.g., WI-123:) before the title.
FIRST_COL.showTitleBooleanSee applicationWhen true, the first column displays the work item title text. Set to false if only the ID is needed.
FIRST_COL.showIconBooleanSee applicationWhen true, the first column displays the work item type icon before the label. Type icons help visually distinguish work item types (task, milestone, work package) in the grid.
diagram
Set FIRST_COL.showId to true and FIRST_COL.showTitle to false to create a compact first column that shows only work item IDs. This is useful for dense schedules where screen space is limited.

​
Columns List

The COLUMNS list parameter defines additional data columns that appear after the first column. Each column entry is configured with field mapping, label, width, alignment, and render template properties. For detailed column sub-parameters, see Column Configuration Parameters. The default columns list includes:
ColumnFieldDescription
WBSTask numberHierarchical work breakdown structure numbering
TitleTask labelTask label with tree indent
Start dateStart fieldTask start date
End dateEnd fieldTask end date
DurationDuration fieldTask duration value
AssigneeResource fieldAssigned resource(s)

​
Column Custom Field Dependency

When you add a column and set its type to CUSTOM_FIELD, the widget parameter editor reveals two additional sub-parameters:
  • Other Field — specifies an alternate field reference for the custom column.
  • Render — specifies the rendering template for the custom field column.
These parameters are hidden for standard field columns to reduce clutter in the configuration panel.

​
User Settings Persistence

The Gantt saves user-specific grid preferences to the browser’s local storage. The following settings are persisted per user:
SettingDescription
Zoom scaleThe current timeline zoom level (e.g., W for week, M for month).
Column widthsIndividual column widths after user resizing.
Grid widthThe overall grid panel width (the split point between grid and timeline).
These preferences are keyed by the document URL and widget version. When a user returns to the same Gantt page, the saved zoom level, column widths, and grid width are restored automatically.
Use the Reset View toolbar action to clear all saved user settings and restore the Gantt to its default zoom level and column layout.

​
Grid Width Behavior

The grid width (WIDTH parameter) sets the initial width of the left panel. Users can adjust the grid width by dragging the splitter between the grid and the timeline. The adjusted width is saved to local storage and restored on subsequent visits. If no WIDTH parameter is set, the Gantt uses a default width determined by the sum of configured column widths.

​
Configuration Example

To configure a compact grid with work item IDs and a priority column:
  1. Open Widget Properties for the Gantt widget.
  2. In the Table section:
    • Set WIDTH to 400.
    • Set FIRST_COL.showId to Yes.
    • Set FIRST_COL.showTitle to Yes.
    • Set FIRST_COL.showIcon to Yes.
  3. In the Columns section, add a column entry:
    • Set Field to priority.
    • Set Label to Priority.
    • Set Width to 80.
  4. Save the widget parameters.
The Gantt grid now displays a 400px-wide panel with the task label (including icon and ID) in the first column, followed by the default columns and the added priority column.
KB ArticlesSource Code
  • 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/model/columns/Column.java
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/impl/types/TypeConfigWidgetParameters.java
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/widget/GanttWidgetConfig.java
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/view/pageparams.cy.ts