Add a diagram to a Jira issue

To add a diagram to a Jira issue, open the issue, find the Diagram panel, choose Add a diagram, type or paste Mermaid text, and choose Save. The text is stored on the issue itself.

Steps

1. Open the Jira issue.
2. Find the Diagram panel and choose Add a diagram.
3. Type Mermaid text, paste it (```mermaid fences are fine) or choose Start from a template.
4. Check the preview under the text box.
5. Choose Save. Choose Edit diagram later to change it.

Where is a Jira diagram stored?

A Jira diagram made with Text Diagrams is stored as an issue property on that issue, so it moves with the issue and anyone who can see the issue can see the diagram. Nothing is stored on BrightDesk servers; we have none.

How do you download a Jira diagram?

A saved Jira diagram shows Download SVG and Download PNG buttons above it. SVG stays sharp at any size; PNG comes out at twice the drawn size on a white background, ready for slides or chat.

What if the diagram shows an error?

A diagram with a mistake in its text shows the first lines of the error instead of a broken picture. Fix the text and the preview redraws as you type.

Last updated 12 November 2026.