# Adding diagrams to Jira issues

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](https://help.gocapable.com/jira-diagrams/add-a-diagram-to-a-jira-issue.html)                                             |
| Change a diagram already there            | [Edit a diagram on a Jira issue](https://help.gocapable.com/jira-diagrams/edit-a-diagram-on-a-jira-issue.html)                                           |
| Bring in a Visio drawing                  | [Import a Visio file into Jira](https://help.gocapable.com/jira-diagrams/import-a-visio-file-into-jira.html)                                             |
| Learn every control on the panel          | [Diagram (issue panel)](https://help.gocapable.com/jira-diagrams/diagram-issue-panel.html)                                                               |
| Understand the editor and its type picker | [Create / edit diagram editor (shared by all surfaces)](https://help.gocapable.com/jira-diagrams/create-edit-diagram-editor-shared-by-all-surfaces.html) |
| See which diagram types you can use       | [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)      |

---

## 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.](https://help.gocapable.com/jira-diagrams/add-a-diagram-to-a-jira-issue.html)[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.](https://help.gocapable.com/jira-diagrams/edit-a-diagram-on-a-jira-issue.html)[Import a Visio file into JiraTurn a Microsoft Visio .vsdx file into an editable draw.io diagram on a Jira issue.](https://help.gocapable.com/jira-diagrams/import-a-visio-file-into-jira.html)

---

## Related

### [Diagram (issue panel)](https://help.gocapable.com/jira-diagrams/diagram-issue-panel.html)

Every control on the panel.

### [Diagrams stored as ordinary Jira attachments](https://help.gocapable.com/jira-diagrams/diagrams-stored-as-ordinary-jira-attachments.html)

Where the diagram file lives.

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

What the Jira edition leaves out.

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

Quick answers to common questions.

---

_The picture belongs on the ticket._