Skip to main content
Documentation/Elements & Controls Reference/Elements/Basics/Video

Video

Video displays hosted or embedded video, with separate options for the selected provider. YouTube, Vimeo, DailyMotion, and video-file options expose different playback controls.

Add and configure Video

  1. Click Add, choose Video, and place it in the container.
  2. Choose the video under Content > Video > Video.
  3. Set Ratio or custom dimensions and supply a useful Title.
  4. Configure the options for the selected source, then style Design > Container, Lazy Load, and Spacing.
  5. Save your changes.
Video controls in the Breakdance editor
Video controls in the Breakdance editor

This element has no children; use its own controls.

Content and front-end behavior

Ratio controls the player's shape. Provider-specific Load Method choices affect how the player loads, while source-specific controls determine autoplay, looping, muted playback, visible controls, and start times. Keep playback usable when you hide controls or enable background-style playback.

Controls

Responsive varies by breakpoint; Hover has a hover value; Shared applies across both. Linked controls have their own reference. In conditions, = means “is” and ≠ means “is not.”

Content > Video

Setting Purpose and options Behavior
Video Set video. Shared
Ratio 16:9, 16:10, 4:3, 1:1, 21:9, 3:2, Custom. Shared
Custom width Set the numeric custom width value. When: Ratio = Custom. Shared
Custom height Set the numeric custom height value. When: Ratio = Custom. Shared
Title Item title. Shared

Content > Video Options

Shown when Source ≠ youtube, vimeo, dailymotion.

Setting Purpose and options Behavior
Poster WordPress media. Shared
Autoplay On/off. Shared
Controls On/off. Shared
Loop On/off. Shared
Muted On/off. Shared
Download Button On/off. Shared

Content > YouTube

Setting Purpose and options Behavior
Load Method Lightweight, Lazy load, Full Embed. When: Source ≠ vimeo, dailymotion. Shared

Shown when Source ≠ vimeo, dailymotion and Load Method = Lightweight.

Setting Purpose and options Behavior
Background Image WordPress media. Shared
Logo WordPress media. Shared
Title Item title. Shared
Setting Purpose and options Behavior
Autoplay On/off. When: Source ≠ vimeo, dailymotion and Load Method ≠ Lightweight. Shared
Loop On/off. When: Source ≠ vimeo, dailymotion. Shared
Mute On/off. When: Source ≠ vimeo, dailymotion. Shared
Modest Branding On/off. When: Source ≠ vimeo, dailymotion and Hide Player Controls is unset. Shared
Hide Player Controls On/off. When: Source ≠ vimeo, dailymotion. Shared
Play Inline On/off. When: Source ≠ vimeo, dailymotion. Shared
Privacy mode On/off. When: Source ≠ vimeo, dailymotion and Load Method ≠ Lightweight. Shared
Start Time Start time and unit. When: Source ≠ vimeo, dailymotion. Shared
End Time End time and unit. When: Source ≠ vimeo, dailymotion. Shared
Suggested Videos From same channel, Recommendations. When: Source ≠ vimeo, dailymotion and Loop is unset. Shared

Content > Vimeo

Setting Purpose and options Behavior
Load Method Lightweight, Lazy Load, Full embed. When: Source ≠ dailymotion, youtube. Shared

Shown when Source ≠ dailymotion, youtube and Load Method ≠ Lightweight.

Setting Purpose and options Behavior
Autoplay On/off. Shared
Play Inline On/off. Shared
Loop On/off. Shared
Mute On/off. Shared
Hide Player Controls On/off. Shared
Setting Purpose and options Behavior
Start Time Start time and unit. When: Source ≠ dailymotion, youtube. Shared
Background Image WordPress media. When: Source ≠ dailymotion, youtube and Load Method = Lightweight. Shared

Content > DailyMotion

Setting Purpose and options Behavior
Load Method Lazy load, Full Embed. When: Source ≠ vimeo, youtube. Shared
Autoplay On/off. When: Source ≠ vimeo, youtube. Shared
Controls > Hide All Controls On/off. When: Source ≠ vimeo, youtube and Hide Player Controls is unset. Shared

Shown when Source ≠ vimeo, youtube and Hide Player Controls is unset and Hide All Controls is unset.

Setting Purpose and options Behavior
Controls > Color Color or supported fill. Shared
Controls > Hide Logo On/off. Shared
Controls > Hide Video Info On/off. Shared
Controls > Disable Sharing On/off. Shared
Setting Purpose and options Behavior
Mute On/off. When: Source ≠ vimeo, youtube. Shared
Start Time Start time and unit. When: Source ≠ vimeo, youtube. Shared

Design > Container

Setting Purpose and options Behavior
Width Width. Responsive
Overlay Color or supported fill. Shared
Borders borders controls. See linked controls

Design > Lazy Load

Setting Purpose and options Behavior
Icon Color Color or supported fill. When: Lazy Load is set. Hover
Icon Size Icon size and unit. When: Lazy Load is set. Responsive

Design > Spacing

Setting Purpose and options Behavior
Spacing spacing controls. See linked controls

Troubleshooting

Autoplay does not start

Browser autoplay rules and muted playback affect whether video starts automatically. Check the source-specific Autoplay and Mute controls, and provide usable playback controls.

An option has no effect

Check that you are editing the section for the selected provider. A YouTube setting does not configure a self-hosted video.