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:
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:
- From the Jira menu at the top of your screen, select Structure | Create Structure
- Select Gantt Chart
- 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 Structure
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:
- Open Structure Board and switch to the structure that contains issues you would like to include in your chart
- Use the Layout menu to switch to either Gantt Chart or Gantt + Resources layout
- 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)
- 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.
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:
- Click the Gantt Chart Settings button on the left side of the chart toolbar
- Under Gantt Chart Configurations, click Manage Configurations
- On the Gantt Configurations screen, click Create New Configuration (You can also customize an existing configuration. Simply locate the desired configuration and click Edit.)
Gantt Chart Elements
Once you define the configuration and save the settings, the Gantt Chart opens.
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
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
- Task Details panel, which contains information about the task's timeline and resources.
- 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.
- See Gantt Chart Elements | Task Bars for more details.
- Groups - If an element has children in a structure, it can be shown as a Group (
- 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.
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 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.
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:
- Mouse over the right edge of the task bar you want to change
- Once the mouse pointer changes to the resize tool, click and drag left or right to set the desired duration
See Scheduling Tasks for more details.
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:
- Mouse over the task bar until a black circle appears to the right of the bar
- Press the circle and drag your dependency line to the task you want to link to
- 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:
- Click the link arrow between two tasks to display the Dependency Properties
- Click Remove
For more information about working with and configuring dependencies, see Working with Dependencies.
Tasks included in the critical path are highlighted in red. To switch off this highlighting:
- Select the Options menu in the toolbar
- Uncheck Critical Path
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.
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 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.
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:
- Click the Gantt Chart Settings button
- Under Gantt Chart Configuration, click Edit
- On the Resources page, under Resource Assignment, select the attribute that will be used to assign resources.
- (Optional) Set the default resource capacity, calendar, and time zone
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.
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.