Video Widget
Add hosted or external videos with playback controls.
The Video widget supports uploaded videos or external links (YouTube, Vimeo, Loom, Wistia), including provider thumbnails or custom poster images.
Add a Video widget
1
Open the widget picker
In the page editor, open Widgets.
2
Drag Video
In Media, drag Video (video icon) onto the page.
3
Open Video Settings
Click the widget and choose Video Settings.
Video Settings
Tabs include:
- Video: set Video Source to Upload Video or External Link. Use Video URL to paste an external link, or click Click to select video to choose an upload. Add a title in Enter video title and set thumbnails using Select Custom Thumbnail / Change Custom Thumbnail.
- Playback: toggle Show Title, Autoplay, Loop, Muted, Show Controls, and Show Chapters for hosted videos with available chapters. When controls are on, choose which buttons appear (Play Button, Seek Back Button, Seek Forward Button, Mute Button, Volume Slider, Captions Button, Fullscreen Button, Time Display, Timeline/Progress Bar, Playback Speed, Picture-in-Picture Button, Quality Selection).
- Border: adjust border radius and shadows.
For private Vimeo links that include a share hash, paste the full Vimeo URL or embed snippet so Hiveality can keep the private playback token with the video.
Thumbnail behavior
- Uploaded videos can use the default generated thumbnail, a timeline thumbnail, or a custom uploaded thumbnail.
- External videos can use the provider thumbnail or a custom uploaded thumbnail.
- When autoplay is off, custom external thumbnails display as a click-to-play poster before playback starts.
Chapters
- Hosted videos can show chapter navigation when chapters are available from Videos.
- Use Show Chapters in the widget playback settings when one page should hide or show chapters differently from the site default.
- If no chapters are available yet, open the video in Video Manager and use Generate Chapters.
Published loading behavior
- Uploaded Video widgets show their poster or selected thumbnail while the hosted player loads.
- Links that use Video in the link selector can open a library video or supported external video in a lightbox. The player loads only after a visitor clicks the link.
- Video backgrounds in rows and columns show a poster first and wait until the section is near view before loading, except for above-the-fold sections.
- Keep a clear thumbnail or poster on important videos so published pages still look intentional while media is loading or when motion is reduced.
Toolbar actions
- Video Settings
- Alignment
- Animation
- Position
- Copy
- Delete
For responsive behavior and mobile playback checks, use Responsive Design.
Related Help Docs
Updated Jun 22, 2026
Was this helpful?