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
String-type fields work for start/end/duration/progress but have precision limitations. Use native Date, Integer, or Float field types for production deployments.
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.
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.
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
Date field mapping (startField, endField) is currently global across all work item types. Per-work-item-type date field mapping is a planned improvement.