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.
Verify in applicationThe 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.
Lag values may reset on older versionsSome 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.
Use negative lag for overlapping tasksIf 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 August 31, 2026