Video

Type: "video". Embed a YouTube video with a responsive aspect ratio container.

Props

Field	Type	Required	Default	Notes
url	string (URL, max 2000)	✓	""	YouTube URL (watch or short)
title	string (max 200)	—	—	Title for a11y
aspectRatio	'16/9'|'4/3'|'1/1'	✓	"16/9"	Container ratio

Example: standard 16:9

{
  "id": "vid01abcd",
  "type": "video",
  "props": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "title": "Introduction to Alusio",
    "aspectRatio": "16/9"
  }
}

Example: 1:1 square

{
  "id": "vid02efgh",
  "type": "video",
  "props": {
    "url": "https://www.youtube.com/watch?v=abc123",
    "aspectRatio": "1/1"
  }
}

Valid URL formats

• youtube.com/watch?v=ID
• youtu.be/ID
• youtube.com/shorts/ID

The builder auto-converts to the embed URL.

Tips

• Use "16/9" for standard landscape videos (default)
• Use "1/1" for vertical content cropped square
• Use "4/3" for classic ratio
• Custom video sources (Vimeo, self-hosted MP4) are not yet supported — roadmap: Vimeo + MP4 support