Column Configuration Parameters - Nextedy Documentation

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

The Other Field and Render sub-parameters only appear in the widget parameter editor when the column type is set to CUSTOM_FIELD. This progressive disclosure keeps the column configuration clean for standard field columns.

Column Template IDs

The Render 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’s start date using the configured date format.
`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 the nextedy.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.

Set this property in Administration > Configuration Properties:

nextedy.gantt.assignee_column_display_mode=fullname

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 Calculation mode (time or remaining).
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 the Progress 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)

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 custom priority 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.
Save the widget parameters.

The priority field value now appears as a centered column in the Gantt grid.

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

​Column Properties

​Column Template IDs

​Assignee Column Display Mode

​Selected Workload Column

​Progress Column

​Column Width Persistence

​Default Column Set

​First Column Menu

​Configuration Example

​Related Pages

Column Properties

Column Template IDs

Assignee Column Display Mode

Selected Workload Column

Progress Column

Column Width Persistence

Default Column Set

First Column Menu

Configuration Example

Related Pages