Skip to main content

Prerequisites

  • Gantt version 25.3.1 or later
  • Access to the Gantt widget parameter configuration (editor or admin role)
1

Open Work Item Types Configuration

  1. Open the Gantt page in edit mode.
  2. Open Parameters (click the ⚙️ settings icon in the toolbar or access the wiki page parameter editor).
  3. Navigate to Work Item Types Configurations.
  4. Select the Item Type you want to configure.
2

Add Fields to the Dialog

  1. Locate the Additional Dialog Fields section within the selected type configuration.
Additional Dialog Fields configuration showing the list of fields chosen to appear in the +New / edit Work Item dialog
  1. Click to add fields. You can select from available Polarion custom fields defined in your project.
  2. Reorder fields by dragging them in the selection list. The order determines how fields appear in the dialog.
Field selection picker for the dialog, where selected fields can be reordered by dragging

Supported Field Types

Currently unsupported: Rich-text, Dependent Enumerations, Priority, Time Point, and complex fields (comments, attachments, Linked Work Items, hyperlinks).
If you add an unsupported field type, the system displays a warning and ignores the field. You do not need to check compatibility manually.For example, adding the unsupported Priority field to the dialog configuration:
Attempting to add the unsupported Priority field to the Additional Dialog Fields configuration
The field is ignored and the following warning is shown:
Warning that the Priority field type is not supported in the Additional Dialog Fields configuration
1

Handle Workflow-Required Fields

Starting with version 25.7.0, fields required by the initial workflow transition are enforced in the dialog. If a required field is missing from your Additional Dialog Fields configuration, a warning appears in the editor view.For example, an initial action named Set Area is added with the Area field marked as required:
Workflow initial action Set Area with the Area field marked as required
Because the required Area field is not included in the dialog configuration, the following warning appears in the edit view:
Warning in the edit view that the workflow-required Area field is missing from the dialog configuration
Ensure all fields required by the workflow’s initial action are included in the dialog configuration.
Fields already used in Data Mapping (such as startField, endField, durationField, resourceField, or progressField) cannot be added to Additional Dialog Fields. The system prevents this and displays an error. Remove the field from Data Mapping first, or use a different field.For example, the Duration field is already used in the Data Mapping configuration:
Data Mapping configuration showing the Duration field already mapped
Adding that same field to the dialog configuration triggers an error:
Error preventing the Duration field from being added to the dialog because it is already used in Data Mapping
2

Configure Default Values

Custom fields in the dialog can have default values pre-populated when creating a new work item. Default values are supported for:
  • Enum (select) fields: pre-selected option
  • Text (textarea) fields: pre-filled text
  • Float (input) fields: pre-filled numeric value
Since version 25.6.0, Polarion auto-assignment rules are automatically applied when creating work items from the Gantt chart. The correct assignee is set without manual input.
3

Understand Validation Behavior

The dialog enforces these validation rules:
  • Field permissions: Read-only or editable access is determined by Polarion role permissions, not dialog configuration.
  • Required fields: Fields marked as required must be filled before saving. The save button is disabled until all required fields have values.
  • Inline validation: Numeric fields (integer, float) show inline error text when non-numeric characters are entered.
If work item creation fails, the Gantt does not refresh, allowing you to correct the data and retry. Alternatively, you can create the work item via the standard Polarion form and copy the data.Once a custom field is added to the dialog through Parameters, it appears when creating or editing a Work Item. For example, an Enumeration-type Department custom field added to the dialog:
Adding the Department enumeration custom field to the dialog through Parameters
When creating or editing a Work Item, the newly added Department dropdown appears in the dialog:
The newly added Department enumeration field appearing in the create / edit Work Item dialog
A simple String-type custom field behaves the same way in the dialog:
A simple String-type custom field shown in the create / edit Work Item dialog

Verification

You should now see the configured fields appear in the create/edit dialog when you click ➕ New and select the configured work item type. Required fields display a red asterisk, and the save button enables only after all required fields are filled.

See Also

Last modified on July 10, 2026