Document toolboxDocument toolbox

Gantt Chart Elements

Every Gantt chart consists of two parts: 

  • Work breakdown structure (left), which defines the scope of work and is built using Structure.

  • The chart itself (right), which visualizes your tasks on the timeline, showing their start and finish dates, dependencies between them, and other information.

Structure and Gantt

This guide assumes you already have a working knowledge of Structure - if not, you should review Getting Started with Structure before continuing. 

Toolbar

Using the toolbar, you can:

Gantt toolbar

Timeline

Your timeline contains visual representations of tasks, dependencies, progress, milestones, and other key dates. It is also where you will do most of your work. You can adjust tasks and dependencies directly from your timeline.

Task Bars

Issues are represented in the chart as task bars.

  • The position of each task on the timeline is based on the project start date, task estimates, and dependencies, or manually entered set Start/Finish dates.

  • If you have configured Gantt to track task progress, it will be shown inside the task bars.

  • Completed tasks can be marked with a check icon.

  • If a task is part of the critical path, it can be highlighted with an orange outline.

You can show or hide many of these elements using the Display Options menu.

Task Details Panel

Clicking a task bar will display the Task Details panel, which contains information about the task's scheduling and resources. 

For more information, see Task Details Panel.

Dependencies

Dependencies are displayed as arrows between task bars.

  • Click the arrow to show the Dependency Properties.

  • To show/hide dependency arrows, use the Display Options menu.

  • You can also create new dependencies from the Gantt chart - see Dependencies.

For more information about managing dependencies, see Dependencies Configuration.

Groups

Items with children in the structure (for example, an epic with child issues underneath it), can be displayed on the timeline as a Group.

  • The start date and duration of a group are calculated automatically based on the start dates and durations of the items it contains.

  • If the group is an issue that has its own start date and duration values, these are ignored.

  • Progress for the group is calculated based on its children's progress; its own progress is ignored.

To turn grouping on or off, go to Settings | Scheduling and select/deselect Treat parent issues as groups.

Expanding/Collapsing Groups

To show or hide the tasks within a group, click the triangle to the left of the group.

Resources

To view resource allocation on your Gantt chart, click the Resources button in the Gantt toolbar.

The Resources section of your chart is split into two panels:

  • Resources - Displays a list of all resources based on your Resources Configuration.

  • Resource Usage - Displays the workload for each resource at a given time. Items in orange indicate the resource is overallocated.

For more information about managing resources, see Resources and Resource Usage.

Timeline Header

By default, the timeline header displays date and timeline increments, both of which change depending on your view level:

  • Zoom out to see larger intervals: months, quarters, half years, or years.

  • Zoom in to see more granular details: weeks, days, or hours.

You can also visualize other time-based intervals:

Time Scale

You can quickly focus your timeline in a variety of ways:

  • Zoom in or out to see more or less of your timeline

  • Scroll horizontally or vertically

  • Hold the Shift key and drag the chart with your pointer

  • Navigate to the current date with the Today button

  • Navigate to the current task with the Scroll to Task button (only appears if the currently selected task is not visible)

Zoom Level

To adjust the zoom level of your chart, use the + or - magnification buttons in the toolbar. Or you can view issues based on a specific time scale, such as weekly or monthly, by pressing the three dots beside the magnification buttons.

Week Numbers

If you zoom out so that weeks are shown, Gantt will list both the dates and the corresponding week numbers.

 

Project Start Day

The project start date is indicated by a green vertical line. To see the exact date, hover over the line.

Fix Versions

Fix Version markers display version names. By hovering over a marker, you can also see the release date and project key (if versions are shown for multiple projects).

Display Options

The Display Options menu allows you to select which elements are shown on the chart.

You can show/hide:

  • Summary

  • Issue Key

  • Resources

  • Critical Path

  • Progress

  • Dependencies

  • Chart Warnings (such as another time zone or different calendar)

  • Task Indicators (see Task Indicators)

  • Sprints (Note: if this option is switched off, sprints will still be displayed when dragging sprint-scheduled tasks.)

  • Custom chart markers

  • Status Bar

Sprints

If you select a task that is manually scheduled by sprints, sprints from the corresponding board will be displayed at the top of the timeline.

See Sprints Configuration for more information about displaying sprints on the timeline.

Critical Path

The critical path highlights items that directly affect the project's end date. This includes the task with the latest Finish Date, as well as any items that, if delayed, will also delay that last task, thereby extending the project's end date.

If a task is part of the critical path, it is shown with an orange box around it. The dependencies that make up the critical path are also shown in orange.

To switch off Critical Path highlighting:

  1. Select the Display Options menu

  2. Uncheck Critical Path

Gantt Info

If the source data contains inconsistencies (for example, a cycle of dependencies), the Gantt Info link will appear on the right side of the Structure status bar (next to the Structure Info link at the bottom of the screen). Click the link to view details of the inconsistencies.