Diagrams for Jira
Draw, write or import a diagram right on the Jira work item, in Mermaid, draw.io, Excalidraw, PlantUML, BPMN and more. It’s saved on the issue, where the next person can edit it.
- Built on Forge
Works inside
Cloud
Built on Atlassian Forge
Diagrams are ordinary attachments on the issue, under your Jira permissions.
Diagrams stored as attachmentsCanvas diagrams stay in the browser
draw.io, Excalidraw, BPMN and DMN draw in your browser. Text diagrams render through our hosted service.
What leaves your Jira site
Capable is used by teams at
Diagrams where the work is tracked
Jira has no macros, so the app adds its own places to work: on the issue, across the site and on dashboards.



A Diagram panel on every issue
Add the Diagram panel from the apps button under the summary. Each diagram gets a tab with a preview, and View, Edit and Add sit in the panel’s toolbar. Pin the panel to show on every work item.
- One tab per diagram
- Saved as an issue attachment
- Count badge in the details column
Write it, draw it or import it
Mermaid, PlantUML, D2, Graphviz, DBML and Structurizr as text; draw.io, Excalidraw, BPMN and DMN on a canvas. Each language has starter templates, and Visio files import into the draw.io editor.
- Starter templates per language
- Visio .vsdx import
- Dark mode toggle on each diagram
Every diagram in one place
The Capable Diagrams page under Apps lists the diagrams across your projects, with project and type filters and a list or grid view. Three JQL fields find issues by diagram count, type or last update.
- List and grid views
- Filter by project and type
- JQL search fields
Diagrams on Jira dashboards
The Capable Diagram gadget shows one stored diagram on any dashboard, edited in a split source and preview editor.
- Dashboard gadget
- Split source and preview
What it looks like on an issue
A bug ticket with its retry flow drawn in. Pick a number, or take the tour.
Try Mermaid for a ticket
The Diagram panel’s editor works the same way: source on one side, the drawing on the other. Start from an incident timeline, or pick another sample.
Edit the text: the diagram redraws as you type. Tab moves on to the next control.
In Jira, open the Diagram panel on a work item, choose Add, then Mermaid, and paste this in.
Try it in Jira, freeWhy put diagrams on the issue
| Job | Today | With Diagrams |
|---|---|---|
| Explaining a ticket | Paragraphs describing a flow, or a picture pasted from another tool. | A timeline, topology or flow drawn on the ticket itself, often the fastest explanation of an incident.Source: Diagrams in Jira |
| Keeping it editable | A PNG on the issue that nobody can change without the original file. | The diagram is an editable file on the issue. Open it from the panel, change it and save.Source: Diagrams stored as attachments |
| Finding them later | Diagrams scattered across tickets, with no way to see them together. | One page lists every diagram across your projects, and JQL finds the issues that have them.Source: Site-wide diagram browser |
Up and running in three steps
Step 1: Install
Install it from the Atlassian Marketplace and approve its permissions. There is nothing to configure, and a fresh licence can take a few minutes to activate.
LicensingStep 2: Add the panel
On a work item, open the apps button under the summary and choose Diagram. Pin it to show on every work item if you like.
Diagram issue panelStep 3: Add a diagram
Choose a type, start from a template if you want one, draw or write, and save. The diagram is attached to the issue.
30+ diagram types on an issue
Where teams use it
Teams
Docs and guides
Short, current pages from help.gocapable.com.
- Get startedThe 11 things people actually do with Diagrams for Jira, and the route to each.help.gocapable.com/jira-diagrams/get-started
- Where diagrams are storedDiagrams are saved as ordinary Jira issue attachments, so they travel with normal attachment handling.help.gocapable.com/jira-diagrams/where-diagrams-are-stored
- LicensingWhat people see without a licence, and how long a fresh install takes to activate.help.gocapable.com/jira-diagrams/licensing
Questions, answered from the docs
Each answer links to the page it comes from.
How do I add a diagram to a Jira issue?
Open the apps button under the issue summary and choose Diagram to add the panel, then choose Add. You can also add one from the Diagrams section in the issue details column.
Source: Diagram issue panel
Which diagram types can I use?
More than thirty, including Mermaid, draw.io, Excalidraw, PlantUML, BPMN, DMN, D2, Graphviz, DBML, Structurizr and Vega, from one editor with starter templates for each language.
Source: 30+ diagram types on an issue
Where are diagrams stored?
As ordinary attachments on the issue (.mermaid, .drawio, .excalidraw, .bpmn and so on). They show in the issue’s Attachments field, respect your Jira permissions and travel with normal attachment handling.
Source: Diagrams stored as attachments
Does diagram source leave our Jira site?
draw.io, Excalidraw, BPMN and DMN are drawn entirely in your browser. Text diagrams such as Mermaid and PlantUML are turned into pictures by Capable’s hosted rendering service, and the Jira app has no setting to change that.
Source: What Capable Diagrams for Jira is
Can I find the issues that have diagrams?
Yes. Three JQL search fields cover diagram count, last updated and types, so you can build filters and boards around them. Use JQL’s field autocomplete to pick them.
Source: JQL search for issues with diagrams
Is it part of the Capable suite?
No. Diagrams for Jira is a separate purchase from the Confluence diagrams app and isn’t part of the Capable suite, which is Confluence-only. Diagrams don’t move between the two products: a Jira diagram isn’t a Confluence diagram.
Source: What Capable Diagrams for Jira is
Do diagrams keep a version history in Jira?
No. Saving an edit replaces the diagram’s attachment with a new one, so the attachment’s id, author and date change each time. Diagram history is a Confluence feature.
Source: What Capable Diagrams for Jira is
Recognition
Put your first diagram on an issue
Install Diagrams for Jira from the Atlassian Marketplace and add the Diagram panel to a work item.




