> For the complete documentation index, see [llms.txt](https://docs.birdie.so/birdie-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.birdie.so/birdie-docs/record-my-screen/embed-a-recording.md).

# Embed a Recording

Every Birdie recording can be played straight from your own pages - a help center article, a knowledge base, a changelog, an internal wiki. Viewers watch it where they already are

The embedded player shows the recording and its captions, and nothing else: no title, no console logs, no network requests, no Birdie interface.

{% hint style="info" %}
A recording can only be embedded while it is shared with **Anyone with the link**.
{% endhint %}

### Copy the embed code

1. Open the recording and click **Share**.
2. Under **Who can view this video?**, choose **Anyone with the link** and click **Save**.
3. Open the **Embed on your site** section.
4. Click **Copy**.
5. Paste the snippet into your page's HTML.

The snippet is a responsive 16:9 iframe. It fills the width of whatever container you drop it into, so it works on a narrow sidebar and a full-width article alike:

```html
<div style="position:relative;padding-bottom:56.25%;height:0;overflow:hidden;">
  <iframe src="https://share.birdie.so/embed/YOUR-VIDEO-ID"
    title="Birdie video player"
    style="position:absolute;top:0;left:0;width:100%;height:100%;border:0;"
    allow="fullscreen; picture-in-picture" allowfullscreen></iframe>
</div>
```

If the tool you are pasting into gives you an **Embed** block that asks for a URL rather than HTML, give it just the `src` - the `https://share.birdie.so/embed/…` part.

### In Notion, Gitbook, Confluence or WordPress, paste the link

These tools recognise Birdie links on their own. Paste the ordinary **share link** - the one behind **Copy Link** - and the player appears in place. No snippet, no HTML.

### What your viewers get

|              |                                                      |
| ------------ | ---------------------------------------------------- |
| **Playback** | Play, pause, seek, playback speed, fullscreen        |
| **Captions** | Shown when the recording has been transcribed        |
| **Sound**    | Mute control, when the recording has audio           |
| **Account**  | None needed — anyone who can load the page can watch |

Views from an embedded player are counted with your other anonymous views, so a recording's view count includes people who watched it on your site.

### Making a recording private takes its embeds down

The snippet contains no copy of the recording - only a link to it. Set the recording back to **Workspace members only** (or restrict it by email) and every page it was pasted into shows **This video is private** the next time it loads.

You do not have to find the pages or edit anything. The same applies in reverse: set it back to **Anyone with the link** and the embeds start working again.

{% hint style="warning" %}
Someone who already had the page open can keep watching until they reload it. Changing the setting stops new plays, not one already in progress.
{% endhint %}

### Sharing a link in Slack

Slack, LinkedIn and X do not display an inline player. Pasting a Birdie link there produces a preview card with the recording's thumbnail and title, which opens the recording when clicked.