Skip to main content

​
Prerequisites

  • Advanced dependency types enabled (nextedy.gantt.default.advanced_dependencies=true)
  • The gantt_dependency_metadata custom field exists on your work item types (see Dependency Metadata Storage)

​
How Lag Works

Each dependency link carries an optional lag value measured in days: Lag is stored alongside the dependency type in the gantt_dependency_metadata custom field on the work item.
diagram
1

Edit the Lag Value

  1. Enter Edit mode on the Gantt chart.
  2. Double-click a dependency link arrow between two tasks to open the link editor.
  3. Set the Lag field to the desired number of days. Use a positive number for delay or a negative number for lead time.
  4. Click Save to apply the change.
The exact UI for editing lag may vary by Gantt version. If double-clicking the link arrow does not open an editor, check that your Gantt version supports lag editing.
2

Verify Lag Persistence

After saving, reload the Gantt page. Hover over the dependency link arrow to see a tooltip displaying the link type, role name, and lag value.
Some earlier Gantt versions had an issue where lag values were not persisted correctly and would reset to 0 on page refresh. If you experience this behavior, update to the latest Gantt version and verify that the gantt_dependency_metadata custom field is properly configured.
3

Combine Lag with Auto-Scheduling

When auto-scheduling is enabled, the Gantt takes lag into account when calculating successor start dates. A Finish-to-Start link with a lag of 3 means the successor will be scheduled to start 3 working days after the predecessor finishes.
If two tasks can partially overlap — for example, testing can begin 2 days before development finishes — set a negative lag value (e.g., -2) on the Finish-to-Start dependency link between them.

​
Verification

You should now see:
  • The lag value displayed in the dependency link tooltip
  • The successor task bar shifted by the specified number of days relative to the predecessor
  • Lag values preserved after saving and reloading the Gantt chart

​
See Also

Last modified on July 10, 2026