Diagrams for Jira

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.

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 Attachments field and travel with normal Jira attachment handling.

Text-based diagram types are turned into pictures by Capable's hosted rendering service; draw.io, Excalidraw, BPMN and DMN are drawn entirely in your browser.

There is no admin or project settings screen in the Jira edition, and nothing to set up.

The Jira left sidebar with Apps expanded and Diagrams listed under Your apps, next to an open issue that has a Diagram section.
Diagrams sits under Your apps in the Jira sidebar, which is how you reach the site wide list of diagrams.

#Start here

#Everything else

OverviewWhat it is, how the two products differ, and what it costs you.Get startedThe 11 things people actually do with Diagrams for Jira, and the route to each.GuideThe 7 macros Diagrams for Jira ships, with every setting and its real default.How it worksHow Diagrams for Jira behaves: 10 behaviours worth understanding before you rely on them.AdministrationEvery setting, where it lives, and who is allowed to change it.IntegrationsHow Diagrams for Jira connects to the rest of Capable, and where it deliberately does not.ReferenceLimits, and the things that look like settings but are not available.Troubleshooting24 symptoms, grouped by where they bite.

Written against the app as it behaves today.