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 |
gantt.config.progress_color_overdue = "#e53935";
gantt.config.progress_color_progressdue = "#fb8c00";
gantt.config.progress_color_resolved = "#0AA33A";
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
nextedy.gantt.workitems.unplanned_color=#c7cffb
nextedy.gantt.workitems.unplanned_color_fg=#001379
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.
See Also
