Adding diagrams to Jira issues

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

The Diagram panel puts Mermaid, draw.io, Excalidraw, BPMN and 30 or so other diagram types on any Jira issue. These guides cover adding a diagram, changing it, and bringing in a Visio file.

#Common tasks

You want to

Go to

Put a diagram on an issue

Add a diagram to a Jira issue

Change a diagram already there

Edit a diagram on a Jira issue

Bring in a Visio drawing

Import a Visio file into Jira

Learn every control on the panel

Diagram (issue panel)

Understand the editor and its type picker

Create / edit diagram editor (shared by all surfaces)

See which diagram types you can use

Create and edit 30+ diagram types on a Jira issue

#Guides in this section

Add a diagram to a Jira issueDraw or write a diagram right on a Jira issue with the Diagram panel, saved as an ordinary attachment.Edit a diagram on a Jira issueChange a diagram already on a Jira issue from the Diagram panel, and know what saving does to the attachment.Import a Visio file into JiraTurn a Microsoft Visio .vsdx file into an editable draw.io diagram on a Jira issue.

The picture belongs on the ticket.