A live image is a plain image URL for a diagram that follows the diagram as it changes: the server keeps an SVG snapshot that re-renders whenever the diagram is saved, so wherever you place the URL shows the current diagram. It is the companion to an embed: the embed is interactive (pan, zoom, live updates), while a live image is a single static picture, which is exactly what you need somewhere an <iframe> is not allowed, like a GitHub README or a Markdown file.
How it differs from an embed
Both come from a share link and both stay current, but they suit different homes:
- An embed is an interactive frame: readers can pan and zoom, and it updates in real time. Best for wikis, Notion, and your own pages.
- A live image is a static SVG served at a URL. It does not pan or zoom, but it drops into anywhere that accepts an image, including places that strip iframes. The server refreshes its snapshot after the diagram is saved, so the image catches up to your edits on the next load.
Getting a live image
 snippet, or Copy HTML for an <img> tag.The image serves a cached snapshot that re-renders after the diagram is saved, so editing the diagram updates the image the next time it loads. The URL also carries a short public cache window, so a page may show the previous version for a brief moment after an edit.
Scoping the image to one tab
By default the image shows the diagram's first tab. When the diagram has more than one tab, the Live image menu also shows a Tab dropdown: pick a tab and every copy option (image URL, Markdown, HTML) carries a tab parameter that scopes the image to that tab. That way a README can show the overview tab while a design doc shows the detail tab, each from its own URL.
When it is not offered
The Live image menu is hidden for a link that has a share password. An <img> request cannot supply a password, so the server refuses an image for a gated share rather than leak it, and offering the option would only mislead. Remove the password to use a live image, or use the embed, which can prompt for the password inside its frame.
Privacy and self-hosting
A live image only exposes what its share link exposes, as a flat picture with no editing actions. It works on self-hosted instances with no external services: the URL is built from your own origin, so a self-hosted diagram produces a self-hosted image.
A live image in your project's README keeps the architecture diagram beside the code and always current, without anyone re-exporting and re-committing a PNG.
Was this article helpful?