Hyperclay
  1. Hyperclay
  2. Docs
  3. Sharing and teams
  4. Share links

Share links

Create a view link or an edit link for one document, and know exactly what each link does and does not reach.

A share link is a URL with a token in it: anyone you send it to can open the document with no account and no sign-in. Each document can have one view link and one edit link, and they grant different things.

Open the document’s … menu and choose Share…. The dialog has Address, View link, Edit link and People tabs. The link tabs let you create a link, copy it, show its QR code or revoke it.

Any account can create a view link, including a free one. Creating an edit link needs a paid plan. If the plan ends, you can still copy or revoke an existing link.

Each document can have two links, and they are different.

  • A view link opens the document, downloads it, reads its JSON, and opens its version history. On a collection dashboard it also reads the collection’s records.
  • An edit link does everything a view link does, and can save. It opens the document in view, like any document; the person switches to editing with the Edit switch or Cmd+Shift+E (Ctrl+Shift+E), or you can add &editmode=true to the link to open it straight into editing.

Both work on a private document. Both are just a URL with a token in it, so anyone you send it to can use it, with no account and no sign-in.

Neither link reaches the owner’s side of the document. No settings, no privacy, no subdomains, no custom domains, no uploads, no code editor, no template reset, no managing the links themselves, and no deleting a collection record. A link grants exactly what its mode says.

An edit link lets someone change the document’s code. Saving accepts the whole HTML file, so an edit link is not limited to text and CMS fields. Send it to people you trust with the document.

Revoking a link is permanent. The link stops working straight away, any live connection it was holding is closed, and creating a link again gives you a new URL and a new QR code. The old one never comes back.

A share URL contains the document’s current address, so renaming the document, or moving it, or renaming your account invalidates the link. Create a new one after any of those.

Files uploaded from inside a private document stay private with it. Once your account’s uploads are protected, a picture added to a document answers only to people who can open that document, link holders included. Files you upload from the dashboard, and older uploads the protection has not reached yet, are served from their own address to anyone who has it. See Uploads.

A link to a collection dashboard includes the collection’s records. Someone holding a view link can list the records and read one. They cannot delete one.