Share and embed diagrams: links, images, live views and pages

Publish a diagram as a link that stays up to date, embed it as an image or an interactive view in docs, wikis and READMEs, choose who can see it, and share explainers and walkthroughs as pages.

Updated November 19, 2026 · 3 min read

Copying a PNG into five places means five copies to update. A shared link is one published version that every page points to: change the diagram, choose Update link, and every embed shows the new version. This guide covers the kinds of links Flowgraph Studio publishes, who can see them, and how to embed them.

Publish a diagram

In the editor, choose Export, then Share a link → Create link. (Sharing is part of Pro and Pro Max.) You get:

  • The link: an interactive view anyone allowed can open: zoom, pan, full screen, and, when the diagram has a story, a step-by-step walkthrough with captions.
  • Image snippets: Markdown and HTML that embed the diagram as an image.
  • An Interactive snippet: an <iframe> that embeds the live view in another site.
flowchart LR
  edit[Edit the diagram] --> update[Update link]
  update --> link[(One published version)]
  link --> wiki[Wiki page]
  link --> readme[README]
  link --> slides[Slide or doc]
  link --> chat[Link in chat]

The address never changes. Update link republishes the latest version, and the image updates everywhere it's embedded. Turn off stops the link and its images at once; Account settings lists every link you've published.

Embedding

In Markdown (GitHub, GitLab, most wikis):

![Checkout flow](https://flowgraph.studio/i/AbC123.svg)

In HTML, use the image, or the interactive view:

<img src="https://flowgraph.studio/i/AbC123.svg" alt="Checkout flow">

<iframe src="https://flowgraph.studio/v/AbC123" title="Checkout flow"
  width="100%" height="480" style="border:0" loading="lazy"></iframe>

Copy the real snippets from the Share panel; they carry your link's address and the right sandbox settings.

Choose who can see it

Access Who can open it Can it be embedded?
Anyone with the link Anyone who has the address; not indexed by search engines Yes
Everyone Public; may appear in search results Yes
Invited people Only people you invite by email, after they sign in with that address No

Invited links add comments: you and the people you invited can comment beside the diagram, pin a comment to a node or a spot, reply, and resolve threads. You get at most one email an hour about new comments, and the editor's Comments button shows them next to the node each one is about.

sequenceDiagram
  actor O as Owner
  participant F as Flowgraph Studio
  actor R as Reviewer
  O->>F: Share with invited people
  F-->>R: Email with the link
  R->>F: Sign in with that address
  R->>F: Comment on the API node
  F-->>O: One email an hour, at most
  O->>F: Fix the diagram, Update link
  R->>F: Resolve the thread

Share more than diagrams: pages

Three other things can be published the same way, with the same access choices, as a page to explore or step through:

  • Prism explainers: readers click a part to read about it and the passages it cites. See Prism explainers.
  • LinkedIn explainers: the infographic, and the carousel to step through or swipe on a phone.
  • Walkthrough carousels: a flowchart explained one step per slide. See explaining a flowchart step by step.

Use Share in each one's editor. Pages have an Embed snippet instead of image snippets, and no comments. They run in a sandbox that allows only their own script and loads nothing from anywhere else, so an embedded page can't reach your site's cookies.

Whiteboards are shared differently

A whiteboard is shared for working together rather than publishing: Share invites people as Can edit or Can view to work on it live, and a view-only link lets anyone watch without an account for 1, 7, or 30 days. See running a review on a shared whiteboard.

Good habits

  • Embed the link, not a screenshot, anywhere the diagram might change.
  • Use "Anyone with the link" for internal wikis: it isn't indexed, and it embeds.
  • Use "Invited people" for drafts under review, and resolve the comment threads before you make it public.
  • Turn off links you no longer need. Account settings shows them all in one place.

Need the image in a build pipeline instead of a page? Render diagrams in CI with the API.

More guides