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
- Edit a Confluence page and type
/mermaidwhere the diagram should go. - Select Mermaid diagram. The editor opens with the template list.
- Pick a template, or choose Start blank and paste the code above. The preview follows every keystroke.
- 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.