How it works

Updated
View as text
Open in Confluence
Open in ChatGPT Open in Claude

Diagrams for Jira lets you create, view and edit 30+ kinds of diagram (Mermaid, draw.io, Excalidraw, PlantUML, BPMN, Graphviz and more) directly on Jira issues and Jira dashboards. Jira has no macros, so instead of macros the app adds four places you can use it: a "Capable Diagrams" page under the Apps menu, a "Diagram" panel on the issue view, a "Diagrams" section in the issue details column with a count badge, and a "Capable Diagram" dashboard gadget. Diagrams are saved as ordinary Jira issue attachments (.mermaid, .drawio, .excalidraw, .bpmn and so on), so they show up in the issue's Attach

#In this section

Create and edit 30+ diagram types on a Jira issueMermaid, draw.io, Excalidraw, PlantUML, BPMN, DMN, D2, Graphviz, DBML, Structurizr, Vega and more, from one editor with a searchable library picker, quick-access strip and per-language starter templates.Diagrams stored as ordinary Jira attachmentsEvery diagram is a real file on the issue (.mermaid, .drawio, .excalidraw, .bpmn …), so it appears in the Attachments field, respects your own Jira permissions, and travels with normal Jira attachment handling and export.Site-wide diagram browserAn Apps-menu page listing every issue that has diagrams, with project and type filters, List and Grid views, thumbnails and paging.JQL search for issues with diagramsThree issue-property search fields (count, last updated, types) let you build filters and boards around diagram content.Diagram count badge on the issueThe Diagrams section in the issue details column carries a live count, calculated server-side.Diagrams on Jira dashboardsA Capable Diagram gadget renders a single stored diagram on any dashboard, edited in a split source/preview editor.Visio importImport a .vsdx or .vssx file straight into the draw.io editor, with the file name carried over as the diagram title.Browser-only rendering for visual editorsDraw.io, Excalidraw, BPMN and DMN are drawn entirely in your browser.Dark mode aware renderingWhen Jira is in dark theme, a toggle on each rendered diagram inverts or restores the drawing.Per-issue tab orderingDiagram tabs sort Newest first or A. Z, and the choice is stored on the issue so everyone sees the same order.

How it actually behaves.