Sharing and Embeds

Share links for live collaboration, optional passwords and expiry, and embeds.

Applies To

Every liveworkspace app

Sharing turns a knowledgebase into something other people can open. A share link lets anyone with the URL join your knowledgebase in real time, with everyone's presence and edits flowing between them. You can protect a link with a password, give it an expiry date, or embed the knowledgebase in another page. None of this needs the other person to sign in: a share link can be handed to a guest who edits without an account, and you can create links as a guest too.

Opening the Share Dialog

Press Share at the top right of the editor. You can also reach it from the command palette or from a knowledgebase's menu in the Explorer.

The dialog draws every link as a pass, a ticket that lets whoever holds it in. Each pass carries a role, which sets what its holder can do:

  • An Editor pass lets the visitor change the knowledgebase with you, live.
  • A Participant pass lets them take part without reshaping the knowledgebase.
  • A Viewer pass lets them watch along.

Each pass shows its link with a copy button inside it. A link opens every tab unless you scope it to one tab. The person you send a one-tab link to sees that tab, and the rest of the knowledgebase never reaches their browser.

Controlling Access

Two self-serve controls let you bound who gets in and for how long:

  • A share password makes every link prompt for a password before it opens.
  • A share link expiry gives a link a lifetime (a week, a month, or six months). When it runs out the link stops working, but stays in your dialog so you can extend or delete it.

These are independent: you can use either, both, or neither. They are layered on top of the link role, not a replacement for it. Share Link Security explains what a link does and does not protect.

Embedding

An embed puts a live copy of a knowledgebase inside another page, like a wiki, a doc, or Notion. Where an <iframe> isn't allowed, like a GitHub README, use a live image from the pass's Live image menu instead. Both are copied from a pass's Embed and Live image menus.

Sharing with Everyone

Proud of a knowledgebase? Share it to the Community, the public gallery where anyone can find it, view it read-only and make their own copy. Looking for a starting point instead? Find knowledgebases in the Community by searching their words and tags. The Share dialog's Community tab, beside Passes, publishes it, edits its listing and takes it down again. It is there for your own knowledgebase, not a team knowledgebase; a guest sees a note and Sign In to Share there instead.

Stopping Sharing

To stop a link working, press the bin (Revoke link) on its pass and confirm with Revoke. Anyone viewing through it is sent out of the knowledgebase straight away, and the URL stops resolving. A revoked link can't be brought back: create a new pass if you change your mind, which gives a new URL.

A knowledgebase kept Offline lives only in your browser, so there is nothing on the server to share yet. Opening Share on one shows a gate instead of the link controls, with a button that uploads it to your account first.

How this works in 5 other apps

Was this article helpful?

Still need help?

Try Troubleshooting, or tell us what you were trying to do.

Contact us