On this page
Excalidraw for Jira (Excalidraw Whiteboard & Mermaid Diagrams) lets you draw hand-drawn whiteboards right on Jira issues and project pages, and paste Mermaid text to get flowcharts, sequence, class, state and ER diagrams in the same scene.
A whiteboard on every issue
Open the Excalidraw panel on an issue and draw: hand-drawn shapes, arrows, images and over 200 shape libraries. The diagram stays with the issue for everyone who works on it.
Mermaid text becomes a diagram you can edit
Paste Mermaid for a flowchart, sequence, class, state, ER or Gantt diagram and it lands in the scene — or insert it as shapes you can restyle. Reopen the source to change it later.
One diagram, many issues
Show one shared scene on several issues and the project page, or start a new diagram from a copy. Annotate a diagram by hand, keep the last 10 versions, and save without overwriting a colleague.
Also included
- Issue panel, project page and global page — a diagram per issue, the project’s diagrams, every scene on the site.
- Faster first open — the viewer loads 0.67 MB of code instead of 3.0 MB; Excalidraw itself loads only when you edit.
- Built-in editors — Mermaid, PlantUML, LaTeX Math, Graphviz, Vega-Lite, WaveDrom; the source of each stays editable.
- Shared scenes and templates — one diagram on many issues, or a new one from a copy.
- Version history — the last 10 versions; conflict-safe saving with merge.
- Over 200 shape libraries inside the app, light and dark themes, non-Latin scripts.
PlantUML and C4, inside Atlassian
PlantUML is the second kind in Insert diagram. Start from an example (Sequence, Class, Activity, Use case, State or C4 container) or paste your own text; labels can be in any language. C4 is built in: !include <C4/C4_Container> and links to C4-PlantUML on GitHub are drawn from the copy inside the app (C4-PlantUML 2.14.0), so nothing is fetched from the internet. Any other !include is refused with a message. A mistake in the text shows as a message with its line number. The diagram lands on the whiteboard, where you can sketch around it, and Update redraws it from the source.
Runs on Atlassian
Built on Atlassian Forge: scenes are stored inside your Atlassian site, rendered in your browser, and the app makes no external calls: the PlantUML engine and the C4 library ship inside it. Anyone who can edit an issue can change its diagram. See the privacy policy.
Further reading
- Mermaid in Jira: 16 apps compared and 7 tested templates — Mermaid templates to paste into a whiteboard, the usual syntax errors, and how the Jira Mermaid apps differ.
- Jira diagram: every way to draw on a work item: what Jira does without an app, and 61 Jira diagram apps counted by kind and installs.
- Mermaid flowchart: syntax, 53 shapes and 15 traps: every shape and arrow rendered, and what survives Insert as shapes.
- Mermaid mindmap: syntax, colours and traps: what a mind map line accepts, and why Insert as shapes gives a mind map as one picture.
- Mermaid syntax: all 33 diagram types, tested: the first line of every diagram type you can paste, and the comments and front matter that break some of them.
- Mermaid timeline: 6 templates, the colon fix and 25 traps: timelines to paste into a whiteboard, the escapes for colons and hashes, and which converter version gives editable shapes.
- Mermaid sequence diagram: syntax, colours and 30 traps: 156 tested cases, and what Insert as shapes keeps from a sequence diagram.
- Mermaid ER diagram: crow’s foot, keys and silent traps: 253 tested cases, and how Insert as shapes keeps the crow’s foot ends of a schema.
- Mermaid class diagram: syntax, arrows and 285 tested lines: 285 tested cases, and what Insert as shapes keeps of classes, arrows, notes and namespaces.
- Mermaid architecture diagram: syntax, icons and 158 tests: 158 tested cases, the five built-in icons, the align fix, and why Insert as shapes gives an architecture diagram as one picture.
Related apps
-
Excalidraw Whiteboard & Mermaid Diagrams for Confluence — the same app for Confluence.
-
Excalidraw Math Equations & LaTeX Whiteboard for Jira — LaTeX Math first.
-
Excalidraw Architecture & Dependency Diagrams for Jira — Graphviz first.
-
PlantUML Diagrams: UML & C4 for Jira — PlantUML and C4 first.
Frequently asked questions
Which Jira permissions does the app ask for, and why?
Two. Read Jira work, to know the issue and project a diagram belongs to and to check you may edit the issue before a save; and app storage, for the diagrams and their last 10 versions. It has no permission to change issues.
Where are the diagrams stored?
In the app's Forge storage inside your Atlassian site. The app makes no outside connections: every renderer and the 200+ shape libraries ship inside it, and Simplify has no server.
How much does it cost?
It is free for sites with up to 10 users. Larger sites pay per user through the Atlassian Marketplace, after a free 30-day trial.
Can I edit a Mermaid diagram after inserting it?
Yes. The Mermaid source is stored with the diagram; choose Update, pick the diagram and change the text. The diagram keeps its place and scale in the scene.
Which diagram languages are included?
All of them in one app: Mermaid, PlantUML, LaTeX Math, Graphviz, Vega-Lite, WaveDrom, plus Excalidraw's own hand-drawn shapes and over 200 shape libraries.
What happens if two people save the same diagram?
Nothing is overwritten. The second person's changes stay in the editor, and they can merge them with the latest version, reload it, or save theirs as a copy. The last 10 versions are kept.
Does the app send diagrams to an external server?
No. Scenes are stored in the app's Forge storage inside your Atlassian site and rendered in your browser; all renderers ship inside the app.
Can one diagram appear on several issues?
Yes. Attach a shared scene to several issues or the project page; a change shows everywhere. Or start a new diagram from a copy of a scene, which you can change freely.
Get Excalidraw for Jira
Free up to 10 users. Install it from the Atlassian Marketplace.