Embed Confluence diagrams in Jira Cloud with the draw.io app

draw.io 08 Jun 2021


You can now embed draw.io diagrams stored in Confluence Cloud in your Jira Cloud issues. This is a new feature for our integration with Confluence Cloud, delivered as part of our draw.io brand.

Visual documentation for systems, processes and software is typically stored in a central knowledge base like Confluence, where all the teams that are involved can access and collaborate on the diagrams.

You also often need to refer to those diagrams in projects and tasks in Jira.

With single-sign-on (SSO) for draw.io between Jira Cloud and Confluence Cloud now implemented, you can search for diagrams that you have stored on Confluence Cloud pages and attach them to Jira issues.

Authorise access to your Confluence Cloud instance

You need to tell the draw.io app for Jira Cloud which Confluence Cloud instance you want to embed a diagram from. That requires you to authorise it via Atlassian’s Cloud.

  1. Open an issue in your Jira Cloud instance.
  2. If you don’t see the draw.io Diagrams section, click on the draw.io logo just under the issue title, then click on Embed Diagram.
    Embed a draw.io diagram from a Confluence Cloud instance to a Jira Cloud issue
  3. Select the Confluence tab, then click on Authorise draw.io to access Confluence and log into your Atlassian Cloud account.
    Before you can embed a draw.io diagram into a Jira Cloud issue, you must authorise draw.io to access your Confluence Cloud instance
  4. If you need to, allow your browser to store all cookies. Select the Confluence instance you want to Authorise, then click Accept.
    Before you can embed a draw.io diagram into a Jira Cloud issue, you must select the Confluence Cloud instance and authorise draw.io to access it

Troubleshoot: If you find you have problems during this authorisation process, make sure you have configured your browser to allow third-party cookies and allow cross-site tracking as this SSO spans multiple Atlassian systems, or use an alternative browser.

Update: Atlassian changed their authorisation method recently. If you can’t see previously embedded diagrams in your Jira issues or embed new diagrams, clear your browsers’ locally saved site data and cookies, and reauthorise the connection between your Jira Cloud and Confluence instances.

Embed a diagram from Confluence Cloud to Jira

  1. Search for the name of the draw.io diagram you want to embed from Confluence Cloud.
  2. Select a diagram on the left to see a larger preview, then click the tick or check mark in the top right to embed it in your Jira issue.
    Search for a draw.io diagram stored in your Confluence Cloud instance, select it, and embed it

View an embedded diagram

Click on the draw.io diagram in your Jira Cloud issue to expand the diagram to the size of your browser window. Alternatively, click on Show in the embedded diagram’s toolbar.
Hover over an embedded draw.io diagram in a Jira Cloud issue to view the toolbar and click on Show to see the full-size diagram

Delete an embedded diagram

Hover over the embedded diagram in the Jira Cloud issue to see the toolbar, then click on Delete (rubbish bin icon).

Using draw.io in Confluence Cloud

The draw.io app for Confluence Cloud offers some additional useful features:

Embed a whiteboard-style diagram with the draw.io Board macro for quick meeting notes, team brainstorming, mockups, remote kanban boards, and more.
Double click on the drawing canvas to add a shape, or click on a direction arrow, or drag a new connection to a shape in another position in the draw.io editor

Customise the draw.io diagram editor for Confluence Cloud to use specific or custom shape libraries, templates, and corporate styles. You can also customise draw.io to use a different diagram editor style by default - Kennedy, Dark, Minimal, or Sketch.

Search for diagrams in your Confluence Cloud instance by filename, label text or the name of a shape.

Set your data residency region to choose where your data or in-scope product content resides at rest in your Confluence Cloud instance, in addition to setting data governance rules centrally for all users on your Confluence instance.

Mass import all of the Gliffy diagrams in your Confluence Cloud instance to draw.io in one step.
Log of the Gliffy mass import to draw.io in Confluence Cloud

Getting started with draw.io diagrams

The draw.io editor, its tools and panels

Follow us on GitHub, Twitter, Facebook.