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 file 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 file is edited. It is the simplest way to keep a file 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 file or an editable one, so readers of the host page can change the file 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 every app 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 file changes, the embedded view follows along.

Adding an Embed to a Page

Open the Share dialog and create or pick a pass for the file.
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 file 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 file. Slack may show only the link's preview card (the name and a picture) until it lists every app 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 file. 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 file. 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 files across a wiki is a tidy way to keep them beside the docs that reference them, always showing the latest version.

Was this article helpful?

Still need help?

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

Contact us