Sharing diagrams with other people
Diagrammo needs no account. A space is the part you only reach for when somebody else is involved.
Two people end up here. If somebody has invited you to a space and you are trying to work out what you have been invited to, this page is the short version. If you have been working on your own and are wondering how one of these spaces comes to exist in the first place, that path is here too. The binding version of all of it is in the terms.
The app on its own has no account
This is worth saying first, because the rest of this site says it too. The desktop app and the editor in your browser are complete on their own: your diagrams are plain text files on your own machine, nothing is uploaded, and there is nothing to sign in to. Everything below is optional, and you can ignore all of it for as long as you are working alone.
What a space is
A space holds diagrams and the people you share them with. You all edit the same diagrams, so nobody emails a file around. Diagrammo Cloud is what the service holding it is called.
There is still no sign-up. Your email address is your identity, and there is no password to choose. The dialog is headed Sign in or make an account and offers two doors: ask for a one-time link and open it, or Continue with Google. If somebody has invited you, there is nothing to accept either: sign in with the address the invitation was sent to and the space is simply there.
How one comes to exist
Nothing above happens on its own. Somebody makes the space, puts diagrams in it and invites people by address. If that somebody is you, this is the whole path.
- Sign in. From the app or from the editor in your browser. A one-time link to your address, or Continue with Google.
- Make a space. In the app it is the + at the top of the folder dropdown, beside your own email address, labelled New space. On the web it is Make a space on your account page. Either works, and the dialog is headed New cloud space and asks for a name.
- Copy diagrams into it. Your originals stay where they are; the space gets its own copy that everyone in it works on.
- Invite an address. An email address and a role, and nothing else — the form reads They join as, and the choices are viewer and editor.
- They sign in. With the address you invited. The space is simply there.
The three roles
A space has one owner and any number of members, and each member holds one of three roles.
| Role | What they can do | What it costs |
|---|---|---|
| Viewer | Reads the diagrams in the space. | Always free, however many of them there are. |
| Editor | Creates and changes diagrams in the space. | One per space is free. More is what a paid plan is for. |
| Admin | The person who made the space. Invites people, changes roles, removes members, deletes it. | One per space, and it cannot be handed to somebody else. |
The invite form puts the cost of that choice in one line, before you send it: Editors take a seat. Viewers are free. Only the Admin — the person who made the space — can invite anybody. Everyone else who wants in asks for it: the space's own page carries an Ask to be let in button, and the Admin decides.
What an invitation does
An invitation is not a key. The email carries a link, but the link is only a hint about where to go: what grants membership is signing in with the address that was invited. Forwarding it to somebody else achieves nothing — they arrive as themselves, and there is no space waiting for them.
That is also why there is no accept step to miss, and why it does not matter which device the link is opened on: the invitation is a fact about an address, not a token in an inbox. It does not stay open forever, though — an unanswered invitation expires, and the owner can send it again. The docs carry the window and the rest of the mechanics.
Where each thing happens
Diagrams are the app's job. The roster is not. Who is in a space, inviting them, and what you have used against the free allowances all live on the web — on your account page and on the space's own page — whether you started in the desktop app or in the browser.
Your copy stays on your machine
Joining a space does not move your work into a browser tab. The app and the web editor keep a local copy of the space's diagrams on your device, so you can keep working with no connection. That copy is yours, it is plain text, and exporting it never depends on paying us. If you are removed from a space, the app deletes that space's local copy the next time it runs — the diagrams belonged to the space, not to your disk.
Showing a diagram on the web is a separate decision
A space is private to its members. Putting a diagram in one does not publish it. Showing a diagram on the web is a deliberate, separate action that turns one diagram into a genuinely public page: anyone with the link can read it and there is no sign-in in front of it. It is unlisted rather than published: the page asks search engines not to index it, and it is not listed anywhere public, so it is not something a stranger can find by searching. That is a request crawlers honour, not a lock — treat a shown diagram as readable by anyone who is given the link. You can stop showing it at any time, though a copy somebody else has already saved is beyond anyone's reach.
That is also what makes a diagram embeddable in a documentation site that always shows the current version — see live links. To put one in Confluence, Jira or Notion, paste its link — the steps are on In docs & notes. The docs also cover spaces end to end — making one, adding people, and what happens to your local copy if you leave.
Embedding a shown diagram with an iframe
Any page that accepts HTML can show a live diagram. Take its link,
https://online.diagrammo.app/d/<id>, change /d/ to
/embed/, and put that in an iframe. The embed is read-only, has no
app chrome, and always shows the author’s latest version. Tools that look
links up by oEmbed find it on their own, so in many of them pasting the
/d/ link is enough.
<iframe src="https://online.diagrammo.app/embed/dgm_01M3PG3DQ6S89W7ZFM5Z06J1CD?theme=light"
width="100%" height="480" style="border:0; color-scheme: light" allowfullscreen></iframe>
The theme parameter picks how the diagram is drawn:
?theme=light or ?theme=dark. Leave it off and the
embed follows the reader’s system setting, which is not always what the
page around it shows. If your page has its own light and dark switch, pass the
page’s current theme, and change the src when the switch
flips — the embed reloads in the new theme. Setting the CSS
color-scheme on the <iframe> also works in
Chrome and Firefox, which hand it to the embed as the reader’s setting.
Safari does not, so the parameter is the dependable way; this page does both.
That snippet, live, following this page’s theme:
What it costs
Paid plans are not on sale yet. An account without one holds up to 25 diagrams, shows up to 5 of them on the web, and owns up to 25 spaces, with one editor per space. People who only read are free and unlimited on every plan — a space that many people read and one person writes never costs anything.
When plans do go on sale they are priced per editor per month, and the terms already set out what happens if you stop paying: nothing is deleted, hidden or made read-only, and your export keeps working.
Been invited to a space?
Open the link in your invitation, or go to online.diagrammo.app and sign in with the address it was sent to — the space is waiting there, and there is nothing to accept. It all works in a browser; the Mac app is optional, and keeps the same space in step on your own machine.
Want to share one?
Sign in at online.diagrammo.app or in the app, make a space, copy the diagrams you want to share into it, and invite people by address. The docs walk it through step by step.