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 insideCloud

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 Jira issue with a file called My journey.mermaid in its attachments, and the Diagram panel below rendering it as a Mermaid user journey.

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

What it looks like on an issue

A bug ticket with its retry flow drawn in. Pick a number, or take the tour.

A Jira work item called Checkout fails on retry, with the Diagram panel showing a Mermaid flowchart and a Diagrams section in the details column.

4 things to notice

Add it from Apps

The apps button under the summary lists Diagram. Choose it to put the panel on this work item, or pin it to every one.

Diagram issue panel
1 of 4

One tab per diagram

Each diagram on the issue has a tab and a preview. View opens it full screen, Edit opens the editor and Add starts another.

30+ diagram types on an issue
2 of 4

A count in the details column

The Diagrams section beside the issue lists its diagrams with a live count, and View, Edit and Delete for each.

Diagram count badge
3 of 4

Saved as an attachment

Each diagram is a real file on the issue, such as a .mermaid or .drawio, so it shows in Attachments and follows the issue’s permissions.

Diagrams stored as attachments
4 of 4

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.

Sample · runs in your browser

Edit the text: the diagram redraws as you type. Tab moves on to the next control.

PreviewSample render

In Jira, open the Diagram panel on a work item, choose Add, then Mermaid, and paste this in.

Try it in Jira, free

Why put diagrams on the issue

Why put diagrams on the issue: before and after
JobTodayWith Diagrams
Explaining a ticketParagraphs 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 editableA 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 laterDiagrams 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

  1. 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.

    Licensing
  2. Step 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 panel
  3. Step 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

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

Put your first diagram on an issue

Install Diagrams for Jira from the Atlassian Marketplace and add the Diagram panel to a work item.

Cookie Settings

We take good care of you and your data. You can read more about how we use cookies, the third parties who set cookies and update your cookie settings here.