Install and set up

Install Diagrams for Jira from the Atlassian Marketplace, open any issue and use the Diagrams panel, or ••• → Diagrams, to create a draw.io, Excalidraw or Mermaid diagram. Press Save to keep it on the issue. Apps → Diagrams lists every diagram you can see.

1 min read

Before you start

  • You need to be a Jira administrator to install the app from the Atlassian Marketplace.
  • People who can browse an issue can view its diagrams. People who can edit the issue can create, edit and delete them. See Permissions.
  • The draw.io editor loads from diagrams.net, so your network must allow embed.diagrams.net, app.diagrams.net and viewer.diagrams.net.

Install the app

  1. In Jira, go to Apps → Explore more apps, search for Diagrams for Jira and install it.
  2. Open any issue. The Diagrams panel appears in the right-hand column.
  3. As an admin, open Jira settings → Apps → Diagrams settings (or Configure in Manage apps) to choose which editors people can use and how AI works.

Still stuck? Email us a screenshot and your board link, or book a 15-minute call.