# Frequently asked questions

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](https://help.gocapable.com/jira-diagrams/diagrams-stored-as-ordinary-jira-attachments.html).

### 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](https://help.gocapable.com/jira-diagrams/add-a-diagram-to-a-jira-issue.html).

### 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](https://help.gocapable.com/jira-diagrams/edit-a-diagram-on-a-jira-issue.html).

### 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](https://help.gocapable.com/jira-diagrams/create-and-edit-30-diagram-types-on-a-jira-issue.html).

### 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](https://help.gocapable.com/jira-diagrams/what-is-not-available.html).

---

## 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](https://help.gocapable.com/jira-diagrams/download-a-diagram-from-a-jira-issue.html).

### 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](https://help.gocapable.com/jira-diagrams/find-jira-issues-with-diagrams-using-jql.html).

### 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](https://help.gocapable.com/jira-diagrams/browse-every-diagram-on-a-jira-site.html).

### 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](https://help.gocapable.com/jira-diagrams/outbound-domains-an-admin-approves-at-install.html).

---

## Related

### [How-to guides and FAQ](https://help.gocapable.com/jira-diagrams/how-to-guides-and-faq.html)

All the how-to guides.

### [Troubleshooting](https://help.gocapable.com/jira-diagrams/troubleshooting.html)

When something looks wrong.

### [What is not available](https://help.gocapable.com/jira-diagrams/what-is-not-available.html)

What the Jira edition leaves out.

---

_Short answers first, the detail one click away._