Share diagrams privately, with your team, or publicly
Keep AI-drawn diagrams private, share them with people or your whole org, or make one public. Every diagram keeps one link, every version is saved, and link previews never leak private titles.
A new diagram is private. In a project you share with others, it starts as a draft only you can see, and you decide when they see it. Every project page says who can see it.
Private, shared, or public
- Draft (how a new diagram starts in a shared project or an org): only you and the project's owner. Tell your AI to publish it, or press Publish on the diagram, when it's ready. In a project nobody else is on, there's no draft step.
- Published, private: you and whoever can see its project.
- Shared with people: add anyone's email to a project and they can view every diagram in it after signing in with that email, with Google or an emailed sign-in link. They can also ask their AI to change them, as new versions (see Editing together).
- Shared with your org: see Orgs.
- Public: anyone with the link can open that one diagram, no sign-in needed. Public diagrams aren't listed anywhere and ask search engines not to index them.
Sharing happens on Diagram, not in your AI app: press Share on a diagram to make it public or private again, and add people on the project's page. Your AI can draw and change diagrams but can't share them, so a prompt hidden in a file or web page can never make your work public.
One link, every version
Each diagram keeps one link for as long as it exists. When it's updated, the same link shows the new version, and the old versions are kept. A page you already have open switches to the new version by itself, so you can leave it open while your AI works. A link you pasted into a pull request last month shows today's diagram.
Editing together
Anyone who can see a project can edit its diagrams: the owner, people they added, and everyone in its org. Open the diagram and press Edit, copy the message, and paste it into the AI app you use (Claude, ChatGPT, Cursor, Codex, and others). If Diagram isn't connected to it yet, the same window shows how. Your AI loads the diagram, asks what to change, and publishes a new version at the same link. Every earlier version is kept, so nothing gets lost: press History on a diagram to see who changed it and when, and click any version to view it. Only the owner can make a diagram public or private (press Share on the diagram), move it, or delete it. People who only have the public link see the current version, never the history.
Orgs
Orgs let a team see each other's projects. Everyone in an org can see every project in it.
- Who's in an org: the people an org admin adds by email. An admin can also set the org's email domain, so anyone who signs in with an address at your company is in automatically, including people who join later.
- Projects stay personal until you move one into the org. Pick the org when you create the project, or press Move on any of your projects (on your dashboard, an org page, or the project's Settings) and choose an org or Personal. You can move a project between orgs or back to personal any time, and single diagrams between your projects. Links never change.
- Sharing just one project: add the person to that project (its Settings → People) instead of the org. They see that project and nothing else.
Joining an org is free. Creating one comes with Pro.
Link previews
Paste a public diagram's link into Slack, iMessage, Discord, LinkedIn, or X and it unfurls with its title. Making a diagram public shares that diagram only: its page and preview never show the project it's in, who owns it, or your org. Private diagrams unfurl as a generic card, so a pasted link never reveals what's behind it.
Is it safe?
- Diagrams run in a sealed-off sandbox. A diagram can't see your account, read your cookies, or act as you, even if its code tried to.
- Your API key is shown once. If it leaks, revoke it on the API keys page and make a new one.
- Nobody at Diagram, including our own admin accounts, can open your private diagrams.
More detail for developers: Security.