Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 35

titleIn Progress

Widget Connector




Structure.Gantt is a Structure extension, which brings planning and resource management features to structures. Structure.Gantt It adds the power of familiar Gantt charts to Jira, so you can instantly visualize issue dependencies and timelines, and understand resource allocations on a global scale.


This document makes a few assumptions:

  1. You are familiar with the basics of Structure add-on for JIRA and have it installed on your server. If you're new to Structure, please check it out on the Atlassian Marketplace or feel free to play with it on our Live Structure Demo Server.
  2. You are running Structure 4.6 or later. Structure.Gantt is not compatible with earlier versions.
  3. You have already installed Structure.Gantt. If not, you can download it from the Atlassian Marketplace or directly from our download page. 

Getting Started

Creating Your First Gantt Chart

Gantt Chart Wizard

If you are not familiar with Structure yet, the easiest way to create your first Gantt chart is through the Gantt Chart wizard.

To open the wizard:

  1. From the Jira menu at the top of your screen, select Structure | Create Structure
  2. Select Gantt Chart
  3. Click Next

In just a few steps, the wizard will help you define your structure and the parameters which will be used for building the Gantt chart, including task start and finish dates, duration, dependencies and more.

To learn more about creating charts with the Gantt Chart Wizard and how to tailor your charts for specific project needs, see Using Structure Wizard.

For an Existing StructureGantt Chart Selection MenuImage Removed

If you already have a structure you want to use for your Gantt chart, you can select one of the existing configurations (or create a new one) and edit the chart manually:

  1. Open Structure Board and switch to the structure that contains issues you would like to include in your chart
  2. Use the Layout menu to switch to either Gantt Chart or Gantt + Resources layout
  3. On the Create Gantt Chart screen, enter the Project Start Date and select one of the available configurations (or click Manage configurations to create a new configuration)
  4. Click Create Gantt Chart

Note: To be able to create Gantt charts (even for existing structures) you must have permissions to create new structures.

For more information about setting up your Gantt chart, see Gantt Chart Settings.

Gantt Chart Configuration

The first step to using Structure.Gantt is to create your own Gantt charts. You can use one of our Gantt Chart templates or add a chart to an existing structure. See Creating a New Gantt Chart for a step-by-step guide to each method.

Image Added

Gantt Chart Configuration

The Gantt Chart configuration defines how the chart is built, including where the chart's information comes from and what fields are used to build it.

Structure.Gantt comes with a predefined "Default" configuration, with several predefined parameters. You can begin with the default configuration and customize it as necessary, or you can create your own custom configurations.

Creating a New Configuration

Structure.Gantt allows you to create custom chart configurations that can be used in multiple charts.

To create a new configuration:

  1. Click the Gantt Chart Settings buttonImage Removed on the left side of the chart toolbar
  2. Under Gantt Chart Configurations, click Manage Configurations
  3. On the Gantt Configurations screen, click Create New Configuration (You can also customize an existing configuration. Simply locate the desired configuration and click Edit.)

For more information, see Gantt Configuration in DetailSee Gantt Configuration for more details.

Gantt Chart Elements

Once you define the configuration and save the settings, the Gantt Chart opens.

Image Removed

Time Scale

The time scale can be easily adjusted to find just the information you need:

  • 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
  • Focus in on the current date with the Today button
  • Navigate to the current task with the Focused Task button (next to the Today button)

Start Date and Current Date

Image Added

Your Gantt chart is composed of the following elements:

  • Time Scale - Allows you to quickly navigate or focus your timeline to view a specific time frame. See Gantt Chart Elements | Time Scale for more details.
  • Start Date - The project start date is indicated by a green vertical dashed line. Mouse over the point at the top to see the exact date.
  • Current Date - The current date/time is indicated by an orange vertical line.


  • Mouse over the point at the top


  • to see the exact date.
  • Task Bars


  • - Structure items are represented in the chart with bars. Clicking the task bar will show the



  • A task's position on the timeline is based either on its dependencies or on manually-set Start or/and Finish dates.
  • If you have configured Gantt to track the progress of tasks, that will be shown inside the bar. To show/hide progress, use the Display Options menu in the toolbar.
  • If a task is a part of the critical path, it is shown red. The rest of the tasks are blue. You can show or hide critical path highlighting using the Options menu in the Gantt toolbar.



  • A group's Start Date and Duration is calculated automatically, based on the Start Date and Duration of the elements it contains.
  • If the group is an issue, which has its own Start Date and Duration values, they are ignored.


  • solid black line that extends from the earliest Start Date to the latest Finish Date of its child tasks). See Gantt Chart Elements | Groups for more details.
  • Dependencies - Dependencies are displayed as arrows between task bars.


  • Click Clicking the arrow to show will display the Dependency Properties. See Dependencies for more information.
  • To show/hide dependency arrows, use the Options menu in the toolbar

For more information about managing dependencies, see Dependencies.

Display OptionsImage Removed

Using the Options menu at the top right, you can show or hide elements in your Gantt chart, including:

  • Item Information: Summary, Issue Key, Resource Assignment
  • Gantt Chart Details: Critical Path, Progress, Dependencies, Chart WarningsCritical Path - Tasks included in the critical path are highlighted in red.
  • Conflicts - Scheduling conflicts are indicated by a dark red line placed on top of the task bar. To review and resolve the conflict, open the Task Details panel. See Scheduling Conflict for more information.
  • Display Options - The Display Options menu allows you to select what elements should be shown in the chart. See Gantt Chart Elements | Options for more details.
  • Status Bar - If there are any inconsistencies in the source data, the Gantt Info link will be shown on the right side of the Structure status bar (next to the Structure Info link Image Added at the bottom of the screen). Click the link to see details of the inconsistencies.

Working with Gantt Charts

Adjusting Start/Finish Date, Manual and Automatic Scheduling

If you have enabled Manual Scheduling and configured fields for the Start and Finish Dates in the configuration, you can adjust them by dragging a task to the desired location. You can also adjust them by changing JIRA Jira fields, either on the issue page or right in the structure (if you have added the columns with your containing the date fields addedto your view).


As you set the Start/Finish Date, the task is considered to be scheduled manually. This means it will stay at the defined position regardless of its dependencies.

To switch back to the Automatic scheduling mode, click the task to see the details panel and toggle the Scheduling option to Auto.

For more information, see Scheduling Tasks.

Adjusting DurationImage Removed

You can use Time Tracking, Story Points or both as tasks' duration.

  • If you use Story Points, you will need to define how many hours are required to complete one story point.
  • If no estimate is set, the default duration from the configuration is used.

To adjust a task's duration:

  1. Mouse over the right edge of the task bar you want to change
  2. Once the mouse pointer changes to the resize tool, click and drag left or right to set the desired duration

For more information, see Adjusting DurationIf you have enabled sprint planning, you can reschedule a task by dragging it from one sprint to another.

See Scheduling Tasks for more details.

Managing Dependencies

Dependencies are defined based on Issue Links. Changing dependencies creates or removes links between issues, and vice versa.

To create a Finish to Start dependency:

  1. Mouse over the task bar until a black circle appears to the right of the bar
  2. Press the circle and drag your dependency line to the task you want to link to
  3. If you have more than one link type set up for Finish to Start dependencies, you may be asked to select the link type you wish to create.

To create other types of dependencies, use the Link button in the toolbar.

To remove a dependency:

  1. Click the link arrow between two tasks to display the Dependency Properties
  2. Click Remove

For more information about working with and configuring dependencies, see Working with Dependencies.

Critical Path

Tasks included in the critical path are highlighted in red. To switch off this highlighting:

  1. Select the Options menu in the toolbar
  2. Uncheck Critical Path

ConflictsImage Removed

Structure.Gantt highlights any scheduling conflicts with a red line (see picture). For example, for finish to start dependencies, if a task is scheduled for a date earlier than its predecessor's Finish Date, Gantt will highlight this conflict.

To deal with the conflict, click the task and select one of the following actions:

  • Respect Link. This will change the task start date to coincide with the predecessor's Finish Date. The task will stay in the Manual Scheduling mode.
  • Auto Schedule. This will switch the task to the Automatic Scheduling mode, clearing its Start Date or Finish Date and schedule it appropriately, based on its predecessor and the dependency type.
  • Ignore. This will remove the highlighting from the task bar, but the conflict will stay and the conflict details will remain in the details panel.

Status Bar

If there are any inconsistencies in the source data (for example, a cycle of dependencies), the Gantt Info link will be shown on the right side of the Structure status bar (next to the Structure Info link Image Removed at the bottom of the screen). Click the link to see details of the inconsistencies.

If you do not have permission to edit the Gantt chart, that information will be displayed in the Status Bar as well.



Managing Resources

Structure.Gantt allows you to assign specific resources, such as a person or a team, to tasks. Once you assign a resource to a task, Structure.Gantt will calculate the resource usage throughout the project.

Resources are assigned to tasks based on a specific Jira field or Structure attribute. Many customers select the Assignee field, or create a custom field, such as a "Team" field. However, you can use almost any JIRA field or Structure attribute (including one calculated through Formulas).

To set how resources are assigned:

  1. Click the Gantt Chart Settings button Image Removed
  2. Under Gantt Chart Configuration, click Edit
  3. On the Resources page, under Resource Assignment, select the attribute that will be used to assign resources. 
  4. (Optional) Set the default resource capacity, calendar, and time zone

For more information, see Resources and Resource Management.

Resource Allocation Chart

Once resources are assigned to taskstrack resource usage on a project (or multiple projects). You can assign resources to issues using a Jira field (such as Assignee or a custom Team field) or a Structure attribute, such as a value calculated through Formulas. Once resources are configured, Structure.Gantt can display the number of hours or percentage of availability assigned to each resource at a given time.

To display the Resource Allocation Chartview your assigned resources and their usage, click the Resources button or switch Layout to "Gantt + Resources."

For more information about working with resources, calendars and units, see Resource Management.

Next Steps

For a more in-depth look at using Structure.Gantt, get started with our complete guide at Creating Your First Gantt ChartTo assign resources to your tasks, see Resources. For additional information, see Working with Resources.