Skip to main content

Gantt Chart

Where configured«Issue Page» → «Helper» button or gear in «Gantt» panel → «Gantt Chart» tab
Where visibleIssue Page (classic view, below attachments)
Settings apply toOnly for you

Purpose​

Add a horizontal Gantt diagram to the classic issue view that lays out every related task — sub-tasks, epic children, and linked issues — on a shared timeline so you can see when each piece of work runs and how its status has changed over time.

How to configure​

Where to find settings​

The Gantt chart settings can be opened in two ways:

Via the issue toolbar:

  1. Open any issue in the classic view and click «Helper» in the issue toolbar.
  2. Select the «Gantt Chart» tab.

Via the chart panel:

  1. Open the Gantt chart panel on an issue page.
  2. Click the gear button in the chart's toolbar.

Both methods open the same settings dialog.

How to configure​

  • Select a scope: choose «Global», «This project», or «This project + issue type». Use «Copy from…» to seed a new scope from an existing one. The most specific scope with settings wins at view time.
  • Set bar start and end sources: build a priority list of date fields or status transitions. Use «Add fallback» and the up/down arrows to set order — the first source that yields a date for each task wins.
  • Choose issue categories: include sub-tasks, epic children, linked issues. For links, optionally restrict by link type and direction.
  • Add exclusion filters: drop tasks you never want on the chart — a task is excluded if any filter matches.
  • Add bar colour rules: highlight work by field value or JQL expression. Rules are evaluated top to bottom; first match wins.
  • Add quick filters: create reusable toggle chips in «field value» or JQL mode. Built-in «Unresolved» and «Hide completed» chips are always available.
  • Pick tooltip fields: select extra fields to show in the hover tooltip.

Click «Save» to persist settings. Settings cascade: project+issue type → project → global. Settings survive browser reload.

How to use​

  • The Gantt section is collapsed by default. Click to expand and load the chart.
  • Zoom and pan: Scroll-wheel zoom, +/- buttons, interval selector («hours», «days», «weeks», «months»), drag-to-pan anywhere on the chart.
  • Hover tooltip: Hover any bar to see the issue key, summary, status, dates, and any extra configured fields.
  • Status breakdown: Enable in settings to split each bar into colored segments (gray = to do, blue = in progress, green = done, red = blocked).
  • Quick filters: Use the chips above the chart to filter visible tasks. Type in the search box for text or JQL search. Multiple chips combine with AND.
  • Open in modal: Click the expand button to view the chart full-screen while keeping zoom and toolbar state.
  • Yellow warnings: Alert chips appear when the chart is incomplete — "No history for X of Y tasks" or "X tasks not on chart". Hover for details.
  • While typing in Gantt inputs, Jira keyboard shortcuts are suppressed.

Usage scenarios​

  • Sprint planning: See all related tasks on a timeline to assess readiness and dependencies.
  • Status review: Use the status breakdown to see how long issues spent in each state.
  • Dependency tracking: Include linked issues to visualize cross-issue dependencies.
  • Team sync: Use the modal view during stand-ups to walk through the timeline.

Troubleshooting​

  • Chart not loading: Check browser console for errors. The chart may fail if Jira API requests are rate-limited.
  • Tasks missing from chart: Check exclusion filters and ensure start/end mappings yield dates for those tasks. Look in the "not on chart" section for reasons.
  • Status breakdown wrong: Verify the status-to-category mapping in settings or the scope's status progress mapping.
  • Settings not persisting: Ensure localStorage is not cleared between sessions and the browser does not block local storage.