Skip to main content

Library & share

Library

Open Library from the top bar (route /library).

  • Browse workspace, organization, and community-style templates.
  • Opening a template loads YAML as a new unsaved diagram (does not overwrite the template).
  • If the current board is dirty, Sphere asks whether to stay or leave.

Visibility

The visibility control on the board sets one of three modes:

ModeMeaning
PrivateOnly you (signed-in owner) can access
Anyone with the linkUnlisted, view-only link — not listed in Library
OrganizationCompany workspace visibility. Implemented on the backend, but the toggle is disabled in the UI today ("coming soon")

Unlisted links are view-only and do not appear as public Library entries unless you publish that way separately.

Share and save

  • Share / Save persist the board as SCAN YAML to the cloud when you're signed in.
  • Ctrl/Cmd+S takes the same path.
  • Offline, signed out, or without save permission: Save still works, but it downloads a .scan.yaml file to your machine instead of saving to the cloud.

Public share URL

Unlisted diagrams load at:

{your-sphere-origin}/s/{diagramId}

For example, https://sphere.example.com/s/8f2c.... Copy the exact link from the visibility / share UI after saving — the domain depends on where your Sphere instance is hosted.