Column Properties
Each column added to the Columns configuration block exposes the following sub-parameters:| Name | Type | Default | Description |
|---|---|---|---|
Field | String | See application | The Polarion work item field ID that this column reads its value from (e.g., priority, status, dueDate). Custom fields are supported. |
Other Field | String | See application | An additional field reference used when the column type is set to custom field. Only visible when the column type is CUSTOM_FIELD. |
ID | String | See application | Unique column identifier used internally and for saving/restoring column widths per user. Must be stable across sessions. |
Label | String | See application | Human-readable column header label. If not set, the field’s Polarion display label is used as a fallback. |
Width | Integer | 300 | Column width in pixels. Can be overridden by user settings when a user resizes the column. |
Align | Enum | left | Text alignment for column cell content: left, center, or right. Numeric fields are typically right-aligned. |
Render | String | See application | Template identifier or function name defining how the cell value is rendered. Only visible when the column type is CUSTOM_FIELD. |
Column Template IDs
TheRender parameter accepts the following built-in template identifiers, each providing a specialized rendering for the column cell:
| Template ID | Description |
|---|---|
deadline | Renders deadline dates in red text when the task is overdue. Uses the configured deadline time format. |
start_date | Renders the task start date. Applies high-precision date correction when highPrecision is false (subtracts one day from the displayed end). |
end_date | Renders the task end date. Applies the same high-precision correction as start_date. |
owner | Renders the list of assigned resources as circles (initials mode) or full names (fullname mode). |
user | Renders a user field value using the same display logic as the owner column. |
standard | Renders a standard duration value in the column cell. |
null | Renders an empty cell. Use this when a column is reserved for layout purposes. |
other | Renders the raw field value as a string with no special formatting. |
Assignee Column Display Mode
The assignee (owner) column supports two display modes, controlled by thenextedy.gantt.assignee_column_display_mode administration property:
| Mode | Value | Description |
|---|---|---|
| Initials | initials | Displays each assigned user as a circle with their initials. This is the default. |
| Full name | fullname | Displays the full display name of each assigned user. |
Selected Workload Column
The Gantt provides a special workload column that displays the planned effort hours for the currently selected resource within the active time range. This column:- Only appears when a resource is selected in the resource view.
- Shows per-task effort hours based on the active
Resource Load Calculationmode (timeorremaining). - Disappears when no resource is selected.
The exact rendering of the workload column values depends on the
resourceLoadMode configuration. Verify the column behavior with your specific Gantt version.Progress Column
The progress column template renders numeric progress values rounded to two decimal places. The progress value corresponds to the field configured in the Data Mapping Parameters as theProgress Field.
Column Width Persistence
When a user resizes a column by dragging the column border, the new width is saved to the browser’s local storage. On subsequent page loads, the Gantt restores the saved column widths automatically. This persistence is keyed by the column ID, the document URL, and the widget version. To reset all column widths to their defaults, use the Reset View toolbar action.Default Column Set
The Gantt ships with the following default columns:| Column | Description |
|---|---|
| WBS (task number) | Hierarchical task numbering |
| Title | Task label with tree indent |
| Start date | Task start date |
| End date | Task end date |
| Duration | Task duration value |
| Assignee | Assigned resource(s) |
First Column Menu
The first grid column header contains a menu icon that opens the Gantt menu. This menu provides access to column visibility toggles, scale options, and navigation actions.Configuration Example
To add a custompriority column to the Gantt grid:
- Open Widget Properties for the Gantt widget.
- In the Columns section, add a new column entry:
- Set Field to
priority. - Set Label to
Priority. - Set Width to
100. - Set Align to
center.
- Set Field to
- Save the widget parameters.
Related Pages
- Table and Grid Configuration — grid width and first column settings
- Data Mapping Parameters — field binding for start, end, duration, progress
- Resource View Parameters — resource allocation display
- Color and Styling Properties — resource marker color customization
- Zoom and Scale Levels Reference — timeline scale configuration
Sources
Sources
KB Articles
- Plans Gantt Widget Parameters
- Gantt Page Parameters
- Gantt - Configuration Properties and default values
prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/columns/Table.javaprod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/columns/Column.javaprod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/impl/types/TypeConfigWidgetParameters.javaprod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/widget/GanttWidgetDependenciesProcessor.javaprod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/widget/GanttWidgetConfig.java