Easy Tech TutsHow to Embed Draw io in Confluence Easily 2026
By Impran M N
Static diagram exports break the moment your system changes, and jumping to separate design software slows down documentation. This guide shows how to embed a live draw.io diagram directly inside Confluence in 2026.
01Open the diagram macro
In edit mode, type `/draw.io` and select the diagram macro to open the editor window.
02Choose your source
Select Embed draw.io diagram to search and pull a graphic from another space, if one already exists.
03Or connect a cloud file
Use the external tabs to authorize and pull raw vector layouts from Google Drive or OneDrive.
04Build your diagram
Drag shapes from the left sidebar, link nodes with vector arrows, and add custom labels.
05Configure viewer settings
Adjust center constraints, lightbox triggers, and visible layers in the right-hand format drawer.
06Publish the page
Click Publish inside the draw.io editor, then click the main page Publish button to lock in the live dashboard.
Frequently asked questions
Will my diagram update everywhere it's embedded if I edit the master copy?
Yes, the canvas coordinates with the draw.io engine so layout components update automatically wherever the master graphic is hosted.
Can I pull diagrams stored in Google Drive or OneDrive?
Yes, you can authorize a connection and pull raw .drawio vector files directly from either service.
Can I reuse a diagram from another Confluence space?
Yes, the Embed draw.io diagram option lets you search and pull an existing graphic from another space.
Can I control which layers are visible in the published diagram?
Yes, the format drawer lets you lock custom layer visibility states before publishing.
Watch the full walkthrough
The same steps, demonstrated on screen from start to finish.
