Product guides
Sharing & public links
There are two ways to share a diagram: invite specific people as collaborators, or publish a read-only public link that anyone with the URL can open.
Invite collaborators
Open the diagram you want to share and use its share controls. Invite people by email, and assign each person a role that decides what they can do. Invited collaborators sign in with their own account, so the diagram shows up in their workspace alongside yours.
You can change someone's role at any time, and there are three to choose from.
| Role | Description |
|---|---|
Viewer | Read-only. They can open the diagram and follow along, but cannot change it. |
Editor | Can edit. They can draw, move, and delete elements on the canvas with you. |
Owner | Full control. Everything an editor can do, plus managing sharing and deleting the diagram. |
Once an editor is in the diagram, you both work on the same canvas in real time. See Real-time collaboration for how live cursors, presence, and comments work.
Publish a public link
A public link is a single URL that anyone can open without an account. Use it to drop a diagram into a doc, a chat, or a tweet. Turn the link on from the diagram's share controls, then copy the URL and send it out. You can turn it back off at any time, which immediately stops the link from working.
Public links are view-only
Anyone who opens a public link can see the diagram, but they cannot edit it. To let someone make changes, invite them as an editor instead.
If you want an extra layer of control, you can set an optional password on the link. People then need both the URL and the password to open the diagram. You can add, change, or remove the password whenever you like.
From the API or CLI
Developers can also turn a diagram's public link on or off programmatically, with the same view-only behavior. See the REST API and the CLI for the details. Inviting collaborators and assigning roles stays in the product, in the diagram's share controls.