Customize Progress-Related Coloring

Default Color Legend

Out of the box, the Gantt uses dynamic coloring to indicate schedule status:

Color	Condition	Meaning
Red	End date is in the past, work item is unresolved	Overdue — should have been finished
Orange	End date is in the future, but progress is behind schedule	Delayed — progress is not keeping pace
Blue	End date is in the future, progress is on track	On track — schedule and progress are aligned
Gray	Work item is resolved	Completed
Light Blue	Start date defaults to today (no scheduled date)	Unplanned — not yet scheduled
Green	Item is set to project type via Item Script	Parent item — schedule derived from children

Starting with version 25.10.2, the Gantt also flags tasks in red when the assigned user has no available working days during the scheduled period. Override the default progress colors for a specific Gantt widget by adding the following to Widget Properties > Advanced > Gantt Config Script:

gantt.config.progress_color_overdue = "#e53935";
gantt.config.progress_color_progressdue = "#fb8c00";
gantt.config.progress_color_resolved = "#0AA33A";

These properties control the colors for the three progress states. The default (on-track) blue color is not configurable via a Gantt Config Script property; use task.taskColor in the Item Script to change it.

Change Progress Colors Across Projects

Set default progress colors at the project or server level under Administration > Configuration Properties:

nextedy.gantt.default.progress_color_overdue=red
nextedy.gantt.default.progress_color_progressdue=orange
nextedy.gantt.default.progress_color_resolved=gray

These administration properties serve as the baseline that individual widgets can override via the Gantt Config Script.

Configure Unplanned Item Colors

Unplanned items (those with no scheduled start date) have their own color properties:

nextedy.gantt.workitems.unplanned_color=#c7cffb
nextedy.gantt.workitems.unplanned_color_fg=#001379

The unplanned_color sets the task bar background and unplanned_color_fg sets the text color for unplanned items.

Combine with Custom Item Script Colors

When using dynamic (progress-based) coloring, you can selectively override the default blue color for specific work item types using task.taskColor in the Item Script:

if (wi.getType().getId() === "portfolioepic") {
  task.taskColor = "#bfbfbf";
}

In dynamic mode, task.taskColor changes only the default on-track color. Overdue, delayed, and resolved items keep their progress colors. If you use task.color instead, it overrides all progress-based coloring for that specific item. See Configure Item Colors for the full comparison.

If you want complete manual control over all task bar colors, disable progress coloring entirely with gantt.config.show_progress_colors = false in the Gantt Config Script. Then use task.color in the Item Script to assign colors based on any condition.

Verify

You should now see that task bars use your customized progress colors. Overdue items appear in your configured overdue color, delayed items in your progress-due color, and resolved items in your resolved color. Unplanned items display with the configured unplanned background and foreground colors.

Default Color Legend

Change Progress Colors per Widget

Change Progress Colors Across Projects

Configure Unplanned Item Colors

Combine with Custom Item Script Colors

Verify

See Also

​Default Color Legend

​Change Progress Colors per Widget

​Change Progress Colors Across Projects

​Configure Unplanned Item Colors

​Combine with Custom Item Script Colors

​Verify

​See Also

Default Color Legend

Change Progress Colors per Widget

Change Progress Colors Across Projects

Configure Unplanned Item Colors

Combine with Custom Item Script Colors

Verify

See Also