When you have installed draw.io for Jira Cloud, you can attach diagrams from your personal or company Google Drive directly to Jira issues.

Note: As the diagram file is not hosted within Jira, you can’t use the draw.io app in Jira to edit it. When you need to make changes to the embedded diagram, edit the original diagram file on your Google Drive. The thumbnails and diagrams embedded in your Jira issues will automatically be updated.

  1. Open the Jira issue to which you want to add a diagram from Google Drive. Click on the draw.io icon to display the draw.io Diagrams section.
  2. Click on the three dots in the top of the right panel of your Jira issue, then click on Embed draw.io diagram menu entry. This will open a file picker dialog.
  3. Select the Google Drive tab. If you haven’t allowed draw.io to access your files on Google Drive, click the blue Authorize button, and follow the prompts to allow access.
  4. When you return to the file picker, click Choose.
  5. Find and double-click on the .drawio diagram file you want to embed, or select the diagram then click on Select
  6. Check that the preview is showing you the right diagram, then click Submit

An attachment will be added to the issue recording where to find the diagram (on Google Drive), and a thumbnail of your diagram will appear in the draw.io Diagrams section.

How to view a diagram on a Jira issue

Click on the diagram thumbnail in the draw.io Diagrams section under the issue description to open your diagram in the draw.io lightbox.

If this is the first time you have encountered draw.io in Jira, you will be asked to authorise draw.io to access your Google Drive account. This makes sure you have the appropriate permissions on Google Drive to see the diagram file.

What happens to embedded diagrams if draw.io is uninstalled?

The embedded diagrams and the draw.io diagrams section in your Jira issues will no longer be able to be displayed. Of course, no data on Google Drive is deleted!

When you reinstall the draw.io app for Jira Cloud, as long as the connection with Google Drive is still authorised, your diagrams and files will be displayed again, no further steps necessary.

Tip: You can also embed diagrams in Jira issues from OneDrive, and diagrams from Google Drive in Confluence Cloud pages