Frequently asked questions

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

The questions that come up most, each with a short answer and a link to the page that covers it properly.

#Diagrams on issues

#Where are diagrams stored in Jira?

Each diagram is an ordinary attachment on its issue, named after its title with an extension such as .mermaid or .drawio. It travels with the issue like any other file. See Diagrams stored as ordinary Jira attachments.

#Who can add or edit a diagram on a Jira issue?

Anyone who can add attachments to the issue. Without that permission the Diagram panel is read-only. See Add a diagram to a Jira issue.

#Does editing a diagram keep the old version?

No. Saving replaces the attachment, so download a copy first if you might need the old one. See Edit a diagram on a Jira issue.

#Which diagram types can I use in Jira?

More than 30, including Mermaid, PlantUML, draw.io, Excalidraw, BPMN and Graphviz. TikZ is not offered in Jira. See Create and edit 30+ diagram types on a Jira issue.

#Can I comment on a diagram in Jira?

Diagram comments are a Confluence feature. In Jira, discuss a diagram in the issue's own comments. See What is not available.

#Finding and sharing

#Can I export a Jira diagram as PNG or SVG?

There is no export button in the Jira app. Download the diagram's file from the issue's attachments instead. See Download a diagram from a Jira issue.

#Why does JQL not recognise the diagram fields?

Each field starts with a prefix specific to your site. Type diagram in JQL and pick the field from the suggestions. See Find Jira issues with diagrams using JQL.

#Why is a diagram missing from the Capable Diagrams page?

Diagrams attached before the app was installed are listed once someone adds or deletes a diagram on that issue. See Browse every diagram on a Jira site.

#Is there a settings screen for Diagrams for Jira?

No. There are no admin, project or site settings; the app works as installed.

#Why is an icon blank in my D2 diagram?

The icon's web address could not be reached when the diagram was drawn. The diagram still renders and leaves that icon blank. See Outbound domains an admin approves at install.

Short answers first, the detail one click away.