Nuno Veiga

how to embed a diagram into confluence

So recently I’ve ran into a problem. We needed our shiny systems architecture diagram to be placed on the wiki software that we use internally here at Metabroadcast, Confluence. After a bit of searching, a solution was found that matched all our requirements while maintaining the ability for future edits, for free.

However, there were a few requirements that needed to be respected.

the requirements

  • The diagram has to include all of MetaBroadcast’s system, which is quite large and complex
  • The diagram had to be clickable, so we couldn’t just embed an image
  • Paid software for creation wasn’t an option, as our systems don’t change that often and it would be a superfluous spend.

the instructions

Start by going to This is a Google Drive app developed by the amazing team that does mxGraph. It’ll first ask for your Google credentials and then you’ll have to authorise the app to add itself to your Drive.

Once you’re in, you have the ability to create a diagram; this is a very straightforward and easy interface, there should be no problems with this step. Just create the simplest or the most intricate diagram to your heart’s content. Mine had cake. The combined love of diagrams and cake is a powerful thing.

When you’re done with your diagram, it’s time to put it into confluence. This will require that you have a plugin for displaying HTML on your Confluence pages. If you search the Marketplace for HTML Macro, there are a few free options, just pick the one that strikes your fancy. Once you do, edit the Confluence page where you want your diagram to be in and add the HTML Macro (Insert > Other Macros > Search for the HTML Macro you just installed).

Back to Click on file > embed > HTML. It will open a lightbox like this: embed


The final step is to copy the contents of both of these boxes and paste it into your newly created macro box.

the result

Press save on your Confluence document and voila! Here’s your gorgeous diagram, in HTML format, zoomable, and with links in all the right places! Isn’t it diagramtastic? Here’s what I cooked for this post:




If you enjoyed the read, drop us a comment below or share the article, follow us on Twitter or subscribe to our #MetaBeers newsletter. Before you go, grab a PDF of the article, and let us know if it’s time we worked together.

blog comments powered by Disqus