# Embed

Iframe wrapper with ratio lock and sensible defaults for video, maps, and embeds.

**Install:** `nimbus-docs add embed`  
**Source:** `src/components/ui/embed/`  
**Canonical:** https://nimbus-docs.com/components/embed/

## Agent payload (JSON)

```json
{
  "slug": "embed",
  "name": "Embed",
  "description": "Responsive iframe / video / external content wrapper.",
  "tagline": "Iframe wrapper with ratio lock and sensible defaults for video, maps, and embeds.",
  "install": "nimbus-docs add embed",
  "sourcePath": "src/components/ui/embed/",
  "canonicalUrl": "https://nimbus-docs.com/components/embed/",
  "props": [
    {
      "name": "src",
      "type": "string",
      "required": true,
      "description": "URL to embed inside the iframe."
    },
    {
      "name": "title",
      "type": "string",
      "required": true,
      "description": "Accessible name for the iframe."
    },
    {
      "name": "ratio",
      "type": "string",
      "defaultValue": "\"16/9\"",
      "required": false,
      "description": "CSS aspect ratio (e.g. \"16/9\", \"4/3\", \"1/1\")."
    },
    {
      "name": "allow",
      "type": "string",
      "required": false,
      "description": "Permissions policy passed to the iframe."
    },
    {
      "name": "allowfullscreen",
      "type": "boolean",
      "required": false,
      "description": "Allow the embedded content to enter fullscreen."
    }
  ],
  "registryDependencies": [
    "cn"
  ],
  "dependencies": []
}
```