Gantt charts in Confluence

A Gantt chart shows tasks as bars on a calendar, with their order, length and milestones.

Last updated

When to use it

Use a Gantt chart for a plan with dates: a launch, a sprint, a migration, a cutover night planned hour by hour. Tasks can start after other tasks, skip weekends and be marked as done, active or critical, so the plan and its status stay in one place.

Example

This is the code of the Product launch template: research, build and launch phases with a release milestone.

gantt
  title Product launch
  dateFormat YYYY-MM-DD
  section Research
    Customer interviews :done, r1, 2026-01-05, 10d
    Competitor review :done, r2, after r1, 5d
  section Build
    Design :active, b1, after r2, 10d
    Development :b2, after b1, 20d
    QA :b3, after b2, 7d
  section Launch
    Beta :l1, after b3, 10d
    Marketing campaign :l2, after b3, 14d
    Public release :milestone, m1, after l1, 0d

Vellnar Diagrams draws it like this:

Change a line and the diagram changes with it. Nobody needs the original drawing file, because there is none: the code is the diagram.

Add it to a Confluence page

  1. Edit a Confluence page and type /mermaid where the diagram should go.
  2. Select Mermaid diagram. The editor opens with the template list.
  3. Pick a template, or choose Start blank and paste the code above. The preview follows every keystroke.
  4. Choose Save. The diagram appears on the page.

The documentation covers the editor, the settings and the exports.

Templates

The Templates button in the editor has 6 Gantt charts ready to use:

  • Product launch: Research, build and launch phases with a release milestone.
  • Sprint plan: Two weeks of work, excluding weekends, ending with a demo.
  • Marketing campaign: Content, channels and a webinar milestone.
  • Migration project: Prepare, rehearse and cut over with critical tasks.
  • Cutover night: An hour-by-hour production cutover with a go or roll-back decision.
  • Release train: Fixed-length trains with build, hardening and code freeze dates.

Syntax

The code of a Gantt chart starts with gantt. The Mermaid documentation describes every element of the syntax. Vellnar Diagrams draws it with Mermaid 12.3; if a line has an error, the editor marks the line and keeps the last valid diagram on screen.

More

  • Mermaid in Confluence: how diagrams as code work in a page, and every diagram type.
  • Security: the app asks for no permissions and sends nothing outside Atlassian.