Skip to content

armgit / Cap

Public Imported from GitHub
0

Open source Loom alternative. Beautiful, shareable screen recordings.

2.3 KB
Raw Blame
---
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.