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

# Supported Field Types

> Nextedy GANTT integrates with Polarion work item fields for scheduling, progress tracking, and inline editing via the lightbox.

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

## Lightbox Field Types

The following field types are supported in the Gantt lightbox editor:

| Field Type        | Lightbox Control      | Description                                                     |
| ----------------- | --------------------- | --------------------------------------------------------------- |
| `TEXT`            | Text input            | Standard single-line text entry                                 |
| `INTEGER`         | Numeric input         | Integer value entry                                             |
| `FLOAT`           | Numeric input         | Floating-point value entry                                      |
| `DATE`            | Date picker           | Date-only field with calendar widget                            |
| `DATETIME`        | Date-time picker      | Date and time field with calendar widget                        |
| `DURATION`        | Duration input        | Duration entry with increment/decrement controls                |
| `SELECT`          | Dropdown              | Single-value selection from enumeration options                 |
| `MULTISELECT`     | Multi-select dropdown | Multiple-value selection from enumeration options               |
| `SINGLE_CHECKBOX` | Checkbox              | Boolean true/false toggle                                       |
| `RICH_TEXT`       | Read-only display     | Rich text fields are displayed but not editable in the lightbox |

## Data Mapping Field Requirements

The Gantt uses specific Polarion work item fields for core scheduling data. Each mapping has field type requirements:

| Mapping    | Widget Parameter | Supported Types        | Default Field    | Recommended Type |
| ---------- | ---------------- | ---------------------- | ---------------- | ---------------- |
| Start date | `startField`     | Date, DateTime, String | `gantt_start`    | Date             |
| End date   | `endField`       | Date, DateTime, String | Not set          | Date             |
| Duration   | `durationField`  | Integer, String        | `gantt_duration` | Integer          |
| Progress   | `progressField`  | Float, String          | `gantt_progress` | Float            |
| Resource   | `resourceField`  | User enum, String      | See application  | User enum        |

<Warning title="String Type Limitations">
  String-type fields work for start/end/duration/progress but have precision limitations. Use native Date, Integer, or Float field types for production deployments.
</Warning>

### Valid Field Mapping Combinations

You must configure exactly two of the three date/duration fields. Valid combinations:

| Combination      | Fields Required                | Description                            |
| ---------------- | ------------------------------ | -------------------------------------- |
| Start + End      | `startField` + `endField`      | Duration is calculated automatically   |
| Start + Duration | `startField` + `durationField` | End date is calculated automatically   |
| End + Duration   | `endField` + `durationField`   | Start date is calculated automatically |

## Duration Precision

| Mode     | Value             | Duration Unit | Date Format   |
| -------- | ----------------- | ------------- | ------------- |
| Standard | `Standard (Days)` | Days          | Date only     |
| High     | `High (Hours)`    | Hours         | Date and time |

<Info title="Verify in application">
  High-precision mode changes the Gantt date format globally and requires hour-capable date fields. See [Data Mapping Parameters](/gantt/reference/widget-parameters/data-mapping).
</Info>

## Progress Field Format

The progress field stores completion as a float value:

| Progress | Float Value | Task Bar Fill |
| -------- | ----------- | ------------- |
| 0%       | `0.0`       | Empty         |
| 50%      | `0.5`       | Half filled   |
| 100%     | `1.0`       | Fully filled  |

## Enumeration Field Handling

Polarion enumeration fields are supported in the lightbox as follows:

| Polarion Field Type   | Lightbox Behavior                                               |
| --------------------- | --------------------------------------------------------------- |
| Single enum           | Rendered as a `SELECT` dropdown with all enumeration options    |
| Multi-enum / List     | Rendered as a `MULTISELECT` dropdown with enhanced selection UI |
| User enum (@user)     | Rendered as a `SELECT` dropdown with user list                  |
| User list (@userList) | Rendered as a `MULTISELECT` dropdown with user list             |
| Category              | Rendered as a `SELECT` dropdown with category options           |

## Field Metadata Properties

Each field in the lightbox carries the following metadata:

| Property       | Type    | Description                                                                     |
| -------------- | ------- | ------------------------------------------------------------------------------- |
| `id`           | String  | Internal Polarion field identifier used for reading/writing values              |
| `referenceId`  | String  | Optional remapping identifier that overrides the field ID for data storage      |
| `label`        | String  | Human-readable display label shown as the section heading in the lightbox       |
| `fieldType`    | String  | The lightbox control type (TEXT, SELECT, DATE, etc.)                            |
| `valueType`    | String  | Primitive value type for type-safe conversion (INTEGER, FLOAT, STRING, etc.)    |
| `defaultValue` | Varies  | Default value applied when creating a new task                                  |
| `required`     | Boolean | When `true`, the field must have a value before saving. Marked with an asterisk |
| `readonly`     | Boolean | When `true`, the field is displayed but not editable                            |
| `options`      | Array   | List of selectable values for SELECT and MULTISELECT fields                     |

## Excluded Field Types

The following field types are **not supported** for Gantt editing:

| Field Type        | Reason                                               |
| ----------------- | ---------------------------------------------------- |
| HTML Rich Text    | Complex rendering not compatible with inline editing |
| TimeOnly          | Not applicable to Gantt scheduling                   |
| `status`          | System field managed by Polarion workflows           |
| `resolution`      | System field managed by Polarion workflows           |
| `linkedWorkItems` | Managed through dependency link configuration        |

## Additional Dialog Fields

You can add extra fields to the lightbox beyond the core date/duration/resource fields using the **Additional Dialog Fields** (`fieldFilter`) configuration per work item type.

<Warning title="Field Exclusion Rule">
  Fields already bound as `startField`, `endField`, `resourceField`, `durationField`, or `progressField` cannot be added to Additional Dialog Fields. The Gantt validates this and logs a warning for invalid field references.
</Warning>

## Role-Based Field Access

The Gantt enforces Polarion role-based field permissions in the lightbox:

| Permission              | Lightbox Behavior                 |
| ----------------------- | --------------------------------- |
| User can read and write | Field is fully editable           |
| User can read only      | Field is displayed as read-only   |
| User cannot read        | Field is hidden from the lightbox |

<Note title="Current Limitation">
  Date field mapping (`startField`, `endField`) is currently global across all work item types. Per-work-item-type date field mapping is a planned improvement.
</Note>

## Configuration Example

Configure data mapping fields in the Work Items Gantt widget parameters:

| Parameter      | Example Value    |
| -------------- | ---------------- |
| Start Field    | `plannedStart`   |
| End Field      | `plannedEnd`     |
| Duration Field | `gantt_duration` |
| Progress Field | `gantt_progress` |
| Resource Field | `assignee`       |

## Related Pages

* [Data Mapping Parameters](/gantt/reference/widget-parameters/data-mapping) -- field mapping widget parameters
* [Work Item Types Configuration](/gantt/reference/widget-parameters/work-item-types) -- per-type fieldFilter configuration
* [Work Items Gantt Widget Parameters](/gantt/reference/widget-parameters/work-items-gantt) -- core widget parameter reference
* [Error Messages and Diagnostics](/gantt/reference/error-messages) -- field validation error messages

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