Skip to main content

​
Step 1: Configure the Dependency Role

Before you can create dependency links, tell the Gantt which Polarion link role represents task dependencies:
  1. Open the page in edit mode and access Widget Properties.
  2. Navigate to Work Items > Dependency Role.
  3. Select one or more link roles that represent dependency relationships (e.g., depends_on).
Widget Properties Dependency Role parameter set to depends on, with a Select button and the Data Mapping section below
If you select multiple link roles, the first selected role is used when you create new dependency links by dragging on the chart.
If the Dependency Role parameter is left empty, no dependency arrows are displayed in the Gantt chart, and users cannot create new links.
With the Dependency Role configured and the Gantt in edit mode:
  1. Hover over a task bar to reveal the link handle circles at the left and right edges.
  2. Click and drag from one task’s link handle to another task.
  3. Release the mouse on the target task to create the dependency link.
Animation dragging from a task's start link circle and connecting it to another task's end link circle to draw a dependency
An arrow appears between the two task bars, showing the dependency relationship.
Three chained task bars on the Gantt chart connected by dependency arrows flowing from one task to the next
diagram
By default, Polarion’s depends_on link role connects the dependent item to its source. Gantt automatically reverses the arrow direction so it displays correctly on the Gantt chart (from predecessor to successor). If your Polarion project uses a custom link role where the source points to the dependent item, set the following configuration property in Administration > Configuration Properties:

​
Dependency Types

The default dependency type is Finish-to-Start (FS): the successor cannot start until the predecessor finishes. For advanced dependency types (SS, FF, SF), see Configure Advanced Dependency Types (FS, SS, FF, SF).
Dependency links are supported between work items in the Work Items Gantt. Plans in the Plans Gantt use parent-child relationships only and do not support direct dependency links between plan items.
When a dependency constraint is violated (e.g., a successor starts before its predecessor finishes in an FS relationship), the Gantt displays a red dotted line under the incorrectly positioned task. Move the task to satisfy the dependency rules to resolve the warning.
To remove a dependency link:
  1. Enter edit mode.
  2. Click on the dependency arrow between two tasks.
  3. Confirm the deletion when prompted.
The Polarion link between the two work items is also removed.

​
Verification

You should now see:
  • Dependency arrows displayed between linked tasks on the Gantt chart
  • The ability to create new links by dragging between task bars in edit mode
  • Arrows pointing from predecessor to successor in the correct direction

​
See Also

Last modified on July 10, 2026