Props

PropTypeDefaultDescription
srcstring-Direct video URL (for native HTML5)
youtubeIdstring-YouTube video ID
vimeoIdstring-Vimeo video ID
titlestring-Video title (required)
descriptionstring-Video description
posterstring-Thumbnail image URL
aspectRatio"16/9" | "4/3" | "1/1""16/9"Video aspect ratio
controlsbooleantrueShow video controls
autoplaybooleanfalseAutoplay video
loopbooleanfalseLoop video
mutedbooleanfalseMute video
showSchemabooleantrueInclude Schema.org markup
uploadDatestring-Upload date (ISO 8601 format)
classstring""Additional CSS classes

Native HTML5 Video

Self-hosted video with native HTML5 video player. Supports poster image and standard video controls.

YouTube Embed

Privacy-enhanced YouTube embed using youtube-nocookie.com domain. Automatically handles responsive sizing.

Vimeo Embed

Vimeo video embed with responsive iframe. Clean, professional video hosting.

Aspect Ratios

Support for different aspect ratios: 16:9 (widescreen), 4:3 (standard), and 1:1 (square).

16:9 (Widescreen)

4:3 (Standard)

1:1 (Square)

Usage Notes

  • YouTube: Uses privacy-enhanced embed (youtube-nocookie.com) for better privacy
  • Native Video: Supports all HTML5 video attributes (controls, autoplay, loop, muted)
  • Schema.org: Includes VideoObject markup for improved SEO (title, description, thumbnail, uploadDate)
  • Responsive: CSS aspect-ratio ensures proper scaling on all devices
  • Lazy Loading: Native videos use preload="metadata" for performance