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.

A recording can only be embedded while it is shared with Anyone with the link.

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:

<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.

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.

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.