Skip to main content

Embed a draw.io diagram from OneDrive into Confluence Cloud

Use the Embed draw.io diagram macro to connect to OneDrive and embed a .drawio diagram file hosted there.

  1. Edit the Confluence page on which you want to embed your diagram, then type /draw to insert a macro. Select Embed draw.io diagram.
  2. Click the OneDrive tab. If you haven't allowed draw.io to access your files on OneDrive, click the blue Authorize button, and follow the prompts to allow access.
  3. Click Choose to browse your OneDrive.
    Click Choose to look for the .drawio diagram file in your OneDrive account
  4. Double click a folder to open it. A single click only selects it. Use Shared in the left column for files someone else has shared with you, and Sharepoint for files on a SharePoint site. The list only shows folders and the file types draw.io can open, so a folder that holds nothing but .vsdx or Office files looks empty.
    Browse your OneDrive folders to find the .drawio diagram file
  5. Click the .drawio diagram file you want to embed, then click Open.
  6. Check the preview to make sure you have the right diagram, then click Select.
    Check the preview of your diagram file on OneDrive
  7. Click Insert to embed your diagram file, and publish your Confluence page.
    Click Insert to embed the diagram file from your OneDrive account into your Confluence Cloud page

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

The embedded diagrams and files in Confluence will no longer be able to be displayed. In Confluence, this will be displayed as if the macro is broken (no macros are deleted though). Of course, no data on OneDrive is deleted!

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

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

Embedded diagrams in draw.io for Confluence Cloud