Embed a diagram from OneDrive into Confluence Data Center and Server
Use the Embed draw.io diagram macro to connect to Microsoft OneDrive and embed a diagram file you have stored there.
Tip: If you don’t see this option, your Confluence administrator will need to enable it in the draw.io configuration options.
- Edit the Confluence page on which you want to embed your diagram, then type
/drawto insert a macro. Select Embed draw.io diagram.
- 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.
- When you return to the file picker, click Choose.
- Find and click on the diagram file you want to embed, then click on the blue Open button.
- Check the preview to make sure you have the right diagram, then click click Insert to embed your diagram file from Google Drive into your Confluence Server page.
The Embed draw.io diagram macro will not show a preview while you are still editing the Confluence page. Save the page to see your embedded diagram.
Tip: As well as embedding diagrams from other Microsoft OneDrive, you can embed draw.io diagrams stored in Google Drive, from a different Confluence page, from a URL, or a text file with CSV data stored on the internet.
If authorisation to access OneDrive is revoked
You can revoke draw.io’s authorisation to access your files in Google Drive from within your Google account. If draw.io is not authorised to access the account where the diagram is stored, people viewing the page on Confluence will see a note to Authorize draw.io to access OneDrive.
When you reauthorise draw.io to access your Google Drive files, the diagram you embedded from there will display as before.
If the OneDrive integration is disabled
If an administrator has disabled this feature in the Confluence Administration settings, you will see a Diagram attachment access error. Please contact your administrator, or add it to the Confluence page using the draw.io Diagram macro instead.
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. This will be displayed as if the macro is broken (no macros are deleted though). Of course, no data on Google Drive is deleted!
When you reinstall the draw.io app for Confluence Cloud, as long as the connection with Google Drive is still authorised, your diagrams and files will be displayed again, no further steps necessary.