Embeds - Cap Docs

Video Caps have a dedicated embed route:

https://cap.so/embed/<video-id>

For a self-hosted installation, replace cap.so with the configured web domain. Screenshots cannot be displayed through the video embed route.

Basic iframe

<iframe
  src="https://cap.so/embed/<video-id>"
  title="Cap recording"
  width="100%"
  height="450"
  frameborder="0"
  allowfullscreen
></iframe>

Use the ID from the Cap's share URL. For example, https://cap.so/s/abc123 uses abc123.

Responsive iframe

<div style="position: relative; aspect-ratio: 16 / 9; width: 100%; overflow: hidden; border-radius: 8px;">
  <iframe
    src="https://cap.so/embed/<video-id>"
    title="Cap recording"
    frameborder="0"
    allowfullscreen
    style="position: absolute; inset: 0; width: 100%; height: 100%;"
  ></iframe>
</div>

Adjust the aspect ratio to match the recording or the space reserved by your site.

Access and viewer settings

The embed resolves the Cap's effective organization, space, and recording settings. Private content still requires authorized access, and password-protected content displays a password prompt. Captions and chapters appear only when available and enabled.

Do not use an embed as a way to bypass Cap access controls.

Autoplay

Cap's current embed player does not provide a documented autoplay guarantee. Start playback through the player's controls rather than relying on an autoplay query string, which can also be restricted by browser policy.

Platform notes

HTML, React, MDX, and documentation sites: use the iframe directly.
Notion and similar tools: paste the embed URL into the platform's embed block.
GitHub Markdown: iframes are not supported, so link to https://cap.so/s/<video-id>.
Email: most clients block iframes; use the share link instead.

Troubleshooting

Confirm that you used the video ID rather than the complete share URL in the route.
Confirm that the Cap has not been deleted and that the viewer satisfies its access rules.
Open the embed URL directly to separate a Cap access problem from a host-site iframe policy.
Check the host site's Content Security Policy and any corporate iframe restrictions.