Timelines in Confluence

A timeline places events in order under the period they belong to.

Last updated

When to use it

Use a timeline for a roadmap, a release history or the minute-by-minute record of an incident. Unlike a Gantt chart it has no durations or dependencies: only periods and what happened in each.

Example

This is the code of the Product roadmap template: two half-years of planned releases.

timeline
  title Product roadmap
  section 2026 H1
    January : Editor and live preview
    March : Themes and export
    May : Template gallery
  section 2026 H2
    July : Version history
    September : Visual editing
    November : Search across pages

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 3 timelines ready to use:

  • Product roadmap: Two half-years of planned releases.
  • Release history: What each version shipped, grouped by major release.
  • Incident timeline: An outage minute by minute, from the first alert to resolution.

Syntax

The code of a timeline starts with timeline. 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.