Skip to Content
DocumentationBlocksVideo

Video Block

Use Video for campaign footage, product demonstrations, editorial motion, embedded YouTube or Vimeo content, and social video embeds from TikTok or Instagram.

Setup Order

  1. Choose the video sourceUse uploaded Shopify video when you own the file, external video for YouTube or Vimeo, or social video when the content lives on TikTok or Instagram.
  2. Set playback behaviorChoose autoplay, sound, controls, and loop intentionally. Autoplay video should usually stay muted.
  3. Add a cover imageUse a cover image when the first frame is weak, autoplay is off, or the video may load after surrounding content.
  4. Configure mobile video when neededAdd a mobile-specific source when the desktop video crop, pacing, or subject placement does not work on phones.
  5. Review sizing and bordersSet custom width, mobile width, aspect ratio, border, radius, and padding after previewing the real video.

Source Options

SourceUse
Uploaded videoShopify-hosted video files managed in the store.
External video URLYouTube or Vimeo videos.
Social URLTikTok or Instagram content.
Mobile-specific videoAlternate mobile uploaded, external, or social video source.

Key Settings

Setting groupWhat it controls
Video sourceUploaded video, external video URL, or social video URL.
PlaybackAutoplay, sound, controls, and loop.
CoverDesktop cover image and mobile cover image.
AccessibilityAlt text for URL-based video when needed.
Mobile videoWhether to use a mobile-specific source and cover.
SizeDesktop and mobile custom width plus URL-video aspect ratio.
BorderBorder style, width, opacity, and radius.
PaddingSpace around the video block.

Playback Guidance

Avoid surprising customers with sound. Use visible controls when customers need to pause, scrub, or replay meaningful content. If product links or text overlays appear near the video, confirm they do not block native controls.

QA Checklist

StateWhat to confirm
AutoplayAutoplay behavior is intentional and does not start with unexpected sound.
ControlsControls are available when customers need them and are not covered by nearby content.
Cover imageThe cover image represents the video and works before playback starts.
Mobile sourceMobile-specific video, cover, and ratio work on narrow screens.
External embedsYouTube, Vimeo, TikTok, or Instagram content loads in the expected market and browser.
Blank sourceA missing optional source does not publish an incomplete content block.