Skip to main content

​
Table Widget Parameters

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

​
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: 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.
Last modified on July 10, 2026