Use the Embed draw.io diagram macro to connect to Google Drive and embed a draw.io 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. When you return to the file picker, click Choose.
  4. Once you have found and selected the draw.io diagram, click Open.
  5. Check the preview to make sure you have the right draw.io diagram, then click Select.
  6. Finally, click Insert to embed your diagram file from OneDrive into your Confluence Cloud page.


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


The embedded diagrams and files in Confluence or Jira 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 Diagram Viewer app, 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 from Google Drive and other Confluence pages.