# Embeds: show the Current version anywhere

Source: https://versodocs.com/docs/embeds

Paste a VersoDocs **share link** into Notion, Confluence, Slack or any tool that reads oEmbed, or paste the **embed code** into any page that accepts an iframe. A live embed always shows the **Current** approved version: publish a new version and every embed updates.

## Plans

|   | Free | Team | Pro |
| --- | --- | --- | --- |
| Embeds + oEmbed previews of shared docs | ✓ | ✓ | ✓ |

## Embed a document

1. Open the document → **Share** → create a public link (read-only).
2. Click **Copy embed code** and paste it where you want the document to appear, or paste the share link itself into a tool that unfurls links.

```html
<iframe src="https://versodocs.com/embed/<share-token>" width="800" height="600" loading="lazy"></iframe>
```

- **Live or pinned:** a share link created from the document embeds the Current version, always. A link shared from a specific version embeds that version, with a note when a newer one is approved.
- **Only shared docs:** embeds work for public share links only. Revoke the link (or let it expire) and every embed stops showing the document.
- **Read-only:** no comments, no editing; **Open in VersoDocs** opens the share page in a new tab.

## oEmbed and link previews

### GET /api/oembed?url=<share URL>&maxwidth=&maxheight=

Minimum plan: All plans

oEmbed 1.0, JSON, `type: "rich"` with the iframe in `html`. Share pages advertise it with `<link rel="alternate" type="application/json+oembed">` and carry OpenGraph tags (title, version, Current or superseded) for link previews.