# Diagram (issue panel)

Shows one tab per diagram attached to the issue, with a 400px-tall preview beneath. Toolbar offers a sort-tabs toggle, View (read-only full screen), Edit and Add. Each tab has a delete affordance. When the issue has no diagrams, a single "Add Diagram" button is shown. The panel refreshes itself when

![A Jira issue with the apps button open under the issue summary, showing a Diagram entry and an Add apps link.](https://help.gocapable.com/images/b3506103-93cd-472a-96bb-8e58e338401c.webp)

The panel is added to an issue from the apps button under the summary, where the app appears simply as Diagram.

---

## Add a diagram

![A Jira issue showing the Attachments section with a file named My journey.mermaid of 165 bytes, with delete and download buttons, and the Diagram panel below rendering that file as a Mermaid user jour](https://help.gocapable.com/images/eae2b851-c039-479c-8765-d19eb1447d6e.webp)

---

## Always show panel

![The Diagram panel on a Jira issue with no diagrams, showing an Add Diagram button, and the panel's three dot menu open with Show for all work items, Collapse and Remove.](https://help.gocapable.com/images/2ac4ac9a-6a27-4a22-b1fe-524274fe7b56.webp)

The three dot menu on the panel header is where you pin the panel to every work item, collapse it, or take it off the issue view.

---

## Related

[Diagrams (issue context panel)A compact list of the issue's diagrams with a badge showing how many there are. Each row s](https://help.gocapable.com/jira-diagrams/diagrams-issue-context-panel.html)

[Capable Diagram (dashboard gadget)Puts a single diagram on a Jira dashboard. In the gadget picker it appears as "Capable Dia](https://help.gocapable.com/jira-diagrams/capable-diagram-dashboard-gadget.html)

[MacrosEvery macro in this capability.](https://help.gocapable.com/jira-diagrams/guide.html)

---

_One macro, documented properly._