"Send it to someone" hides a choice, and it depends on who, or what, is on the other end: a colleague, a stranger or a document.
- Invite link. One person per link, signed in, on the live Grid, and counted against its connections. They can edit if you let them. Sharing & realtime collaboration covers it.
- Publish to the web. A read-only page at its own address, for anyone who has the address. No account, no live session, no seat.
- Embed. That published diagram shown inside someone else's document, such as an image in a GitHub README or a card in Confluence, so the document points at the diagram instead of carrying a screenshot of it.
All three need the Grid's owner to be on Premium. For an image file instead of an address, see Getting diagrams in and out.
Press Publish
Open Share in the top bar and press Publish under Publish to the web. Only the owner gets this button; someone you invited with an admin link does not. The first publish asks for no confirmation, so the page is live as soon as you click, and a globe appears in the top bar. Nothing on the page asks search engines to stay away, so treat the address as public rather than secret.
The dialog then lists four things to copy: the Public address, the Stable SVG URL and two README snippets. A visitor gets the Grid's name as a heading and the diagram, with pan, zoom and a light or dark switch. No socket is opened for them, so they show up in no presence list. The page follows your edits on its own: a visitor sees them on the next load, though a cached copy can lag by up to 30 minutes.
Publishing one frame
If the Grid has frames or swimlanes, What to publish lets you choose The whole Grid or one of them, and changing the choice later takes New address. Choose a frame and the image is cropped to it: nodes and edges that touch the frame are drawn, and the rest is left out of the file.
Putting it in a document
- GitHub README. Paste README / Markdown snippet, or README snippet with dark mode to give light and dark readers their own version.
- Confluence. Paste the Public address as a plain link. It becomes a card with the diagram, with no iframe.
- Anything else that takes an image. Use the Stable SVG URL.
Here the 30 minutes stop applying. A GitHub README image and a Confluence card are copies those services keep, and they can show an older version for as long as they like. GitHub documents one way to drop its copy of a single image, a PURGE request to the image's camo.githubusercontent.com address, and asks that it be used sparingly. To force a fresh fetch in every document, use New address and paste its snippet or link into each document: it is a URL they have not stored. That also retires the old address, so until you paste the new one the document points at a dead address, even if it still shows a stored copy.
New address or Unpublish
- New address asks for confirmation, then retires the old address and publishes at a fresh one. It is not a takedown: anything already copied out of the page, an image or a paragraph, is out, and a reader's cached copy can linger for 30 minutes.
- Unpublish removes the page. The address stops resolving right away, cached copies can keep showing it for up to 30 minutes, and publishing again creates a different address. Use it when the content, not the URL, is the problem, and take the embed out of any document too, since unpublishing does not clear a copy GitHub or Confluence already holds.
Revoke all shared access takes the page down too, and so does deleting the Grid, which restoring it does not undo; Deleting a Grid, and getting it back has the detail.
If the owner's plan lapses
Publishing is checked when the page is served, not only when you press Publish. If the plan lapses, the page pauses, within up to 30 minutes as cached copies expire, instead of quietly staying open: visitors to the page read "This diagram isn’t published", and the Share dialog tells the owner it is paused. A copy GitHub or Confluence already holds can outlast the pause. The address is kept and works again within 30 minutes of the plan coming back, and Unpublish stays available the whole time.
Before the link travels
Draw the design of the Video Streaming Platform Challenge on a new Diagram Grid, since Share is not offered on the Challenge's own Grid. Publish it and open the Public address in a private window, which has no session and none of your browser's cached copies, so you see what a stranger sees. Read the heading and every label before you paste the address anywhere.