Open source Loom alternative. Beautiful, shareable screen recordings.
Rust appcapcossloommacnextjsnextjs15open-sourceossreactrecordrustscreen-capturescreen-recorderscreenshotsolidjstauritauri-apptypescriptvite
---
title: "Embeds"
summary: "Embed a Cap video in a website or documentation page"
tags: "Sharing, Integration"
---
Video Caps have a dedicated embed route:
```text
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
```html
<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
```html
<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.