Embeds

Put it live inside another page with a ready-made embed snippet.

Applies To

Every liveworkspace app

An embed places a live copy of a knowledgebase inside another page, like a wiki, a doc, Notion, or your own site. It hides the editor chrome and stays up to date as the knowledgebase is edited. It is the simplest way to keep a knowledgebase visible where your readers already are.

What an Embed Shows

The embed is built from a share link, and it honours that link's role: it embeds a read-only knowledgebase or an editable one, so readers of the host page can change the knowledgebase right there only if the link is an Editor's. Pick the pass to match: a read-only pass when the page is for an audience, an Editor pass when it is for collaborators.

Inside the frame, the embed:

  • hides the header and the tab bar, leaving a clean view,
  • keeps a small Open in liveknowledge badge that opens the full share view in a new tab,
  • stays in the same realtime room as any viewer, so it live-updates: when the knowledgebase changes, the embedded view follows along.

Adding an Embed to a Page

Open the Share dialog and create or pick a pass for the knowledgebase.
Open the pass's Embed menu, under its link, and choose Copy iframe for a ready-made <iframe> snippet, or Copy embed URL for the bare URL.
Paste it into your page, wiki, or doc: the iframe snippet drops in directly, while the embed URL suits tools that turn a pasted link into an embed themselves.

If the knowledgebase has a share password, readers are prompted for it inside the embed frame. A link scoped to one tab embeds that tab only.

You don't have to copy a snippet at all. Paste the share link itself into a tool that reads oEmbed, such as Notion, Medium or Ghost, and it unfolds into a live, read-only view of the knowledgebase. Slack may show only the link's preview card (the name and a picture) until it lists liveknowledge as an oEmbed provider, so don't count on a live view there.

  • Always read-only. Even a link from an Editor pass unfolds as a viewer, so a public page never hands its readers edit rights. To embed something people can edit, use the iframe snippet from an Editor pass, as above.
  • Only what the link shows. A link that is revoked, expired or in the trash, or that has a share password, doesn't unfold: the tool keeps the plain link. A host may keep an unfolded copy for up to five minutes after you revoke a link, but the frame itself shows the not-found message as soon as it loads.

When an Embed Stops Working

An embed lives exactly as long as its share link. If you revoke the link, or it expires, the frame shows a small not-found message instead of the knowledgebase. Create a new pass and paste its snippet to bring it back.

Privacy

An embed only exposes what the share link exposes: a read-only link's embed is a read-only view, and only an Editor link's embed can change the knowledgebase. Anyone who can read the host page's source can also see the embed URL, so treat an editable embed like handing out the edit link itself.

Embedding several knowledgebases across a wiki is a tidy way to keep them beside the docs that reference them, always showing the latest version.

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