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

# Column Configuration Parameters

> Nextedy GANTT provides configurable grid columns that display work item field values alongside the Gantt chart.

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>;
};

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

<Warning title="Parameter Dependency">
  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.
</Warning>

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

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/umKaPvHwUHw-ZQFM/gantt/diagrams/reference/widget-parameters/columns/diagram-1.svg?fit=max&auto=format&n=umKaPvHwUHw-ZQFM&q=85&s=97d75dccb5c5390861e2849f78db6cf6" alt="diagram" style={{ maxWidth: "780px", width: "100%" }} width="780" height="280" data-path="gantt/diagrams/reference/widget-parameters/columns/diagram-1.svg" />
</Frame>

## 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](/gantt/reference/widget-parameters/resource-view).
* Shows per-task effort hours based on the active `Resource Load Calculation` mode (`time` or `remaining`).
* Disappears when no resource is selected.

<Info title="Verify in application">
  The exact rendering of the workload column values depends on the `resourceLoadMode` configuration. Verify the column behavior with your specific Gantt version.
</Info>

## 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](/gantt/reference/widget-parameters/data-mapping) 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)        |

## 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 custom `priority` column to the Gantt grid:

1. Open **Widget Properties** for the Gantt widget.
2. 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`.
3. Save the widget parameters.

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

## Related Pages

* [Table and Grid Configuration](/gantt/reference/widget-parameters/table-configuration) -- grid width and first column settings
* [Data Mapping Parameters](/gantt/reference/widget-parameters/data-mapping) -- field binding for start, end, duration, progress
* [Resource View Parameters](/gantt/reference/widget-parameters/resource-view) -- resource allocation display
* [Color and Styling Properties](/gantt/reference/configuration/color-properties) -- resource marker color customization
* [Zoom and Scale Levels Reference](/gantt/reference/zoom-scale-levels) -- timeline scale configuration

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