Every diagram opens in a full-screen editor. The bar at the top is the same for all three editors.
| Button | What it does |
|---|---|
| Title | Click to rename the diagram (up to 200 characters). |
| AI | Generate or change the diagram with AI. See Generate with AI. |
| Description | Show the diagram as an image in the issue description. |
| History | Preview and restore earlier versions. |
| Export | Download SVG or PNG, print, or download the source file. |
| Save | Save to the issue (Ctrl+S). The pill beside the title shows Unsaved changes, Saving... or Saved. |
draw.io
The full draw.io editor, with its shape libraries. draw.io's own Save saves to Jira too. When you only view a diagram, it opens in the draw.io viewer with zoom, layers and pages.
Excalidraw
A hand-drawn style whiteboard. The drawing is fitted to the screen when it opens, and Excalidraw's shape-library browser is available. Use the app's Export menu to download it.
Mermaid
Write Mermaid code on the left and see the diagram on the right as you type. Zoom with the −, + and 1:1 buttons and drag to move around. Theme changes only how it looks on your screen. If the code has an error, a red banner explains it and the last working diagram stays on screen.
Important: The Insert Template buttons in the Mermaid editor replace all the code in the box. Copy anything you want to keep first.
Saving and unsaved changes
- Diagrams save only when you press Save. Closing with unsaved changes asks you to confirm Discard & close.
- If you close the browser or reload by mistake, your unsaved changes stay in this browser for 14 days. Next time you open the diagram, press Restore changes.
- If someone else saved the diagram while you had it open, you're told before anything is overwritten, and can choose Overwrite theirs.