← All widgetsWidget 184 · emcp_custom_184

Video Box

Elementor widget2 layouts20 content options23 style options5 panel sections

Built with the EMCP Widget Builder and registered under the EMCP Custom category of the Elementor panel. Search the panel for: video, youtube, vimeo, lightbox, play, poster.

Setup guide

  1. Open a page in Elementor, search the panel for Video Box and drag it into a container.
  2. Content › Video: Source, Video URL, Video File, Poster Image, Use YouTube Thumbnail When No Poster, Play Mode, Aspect Ratio, Autoplay (muted, hosted only) and 8 more.
  3. Content › Play Button: Style, Label, Icon, Zoom Poster on Hover.
  4. Pick a Play Mode: Play in place, Open in lightbox. Each one is shown below.
  5. Style tab sections: Box, Play Button, Text & Badge. Colours, typography and spacing set here are scoped to this widget instance.
  6. Publish. Every option is a standard Elementor control, so it responds to the editor, dynamic tags and global styles as usual.
Conditional options: Video URL appears when Source is youtube or vimeo; Video File appears when Source is hosted; Autoplay (muted, hosted only) appears when Source is hosted.
Ships with its own JavaScript; it runs once per instance and re-initialises inside the Elementor editor preview.
Layout

Play in place

Play Mode = inline

Watch the tour2 minutes
Layout

Open in lightbox

Play Mode = lightbox

Opens in a lightboxYouTube thumbnail used as poster

Options reference

Every control the widget exposes, grouped by panel section. Names in code are the setting keys used by the MCP tools (add-free-widget, update-widget).

Content tab

Video

OptionTypeChoices / rangeDefaultNotes
Source
source		DropdownYouTube, Vimeo, Self-hosted (MP4 / WebM)youtube
Video URL
url		Texthttps://www.youtube.com/watch?v=XHOmB...Shown when source = youtube or vimeo
Video File
file		ImageShown when source = hosted
Poster Image
poster		Image
Use YouTube Thumbnail When No Poster
auto_poster		Toggleon / offyes
Play Mode
mode		DropdownPlay in place, Open in lightboxinline
Aspect Ratio
ratio		Dropdown16:9, 4:3, 1:1, 9:16 (vertical), 21:916/9
Autoplay (muted, hosted only)
autoplay		Toggleon / offShown when source = hosted
Loop
loop		Toggleon / off
Start Muted
muted		Toggleon / off
Show Player Controls
controls		Toggleon / offyes
Start At (seconds)
start		Numbermin 0, max 360000
Overlay Title
title		Text
Overlay Text
desc		Text
Duration Badge
duration		Text
Overlay Text Position
text_pos		DropdownBottom left, Bottom centre, Top left, Centre (under play), Below the videobottom-left

Play Button

OptionTypeChoices / rangeDefaultNotes
Style
play_style		DropdownFilled circle, Pulsing circle, Outlined circle, Rounded square, Frosted glass, Pill with label, Icon onlycircle
Label
play_label		TextWatch video
Icon
play_icon		Iconfas fa-play
Zoom Poster on Hover
hover_zoom		Toggleon / offyes

Style tab

Box

OptionTypeChoices / rangeDefaultNotes
Radius
radius		Slidermin 0, max 80, px16
Border
border		Border
Shadow
shadow		Box shadow
Max Width
maxw		Slidermin 200, max 1600, px/%
Poster Overlay
overlay		Colorrgba(16,24,40,0.25)
Poster Overlay on Hover
overlay_h		Colorrgba(16,24,40,0.4)
Poster Filters
poster_filter		Css_filter

Play Button

OptionTypeChoices / rangeDefaultNotes
Size
play_size		Slidermin 32, max 200, px76
Icon Size
play_icon_size		Slidermin 10, max 100, px26
Icon Color
play_color		Color#101828
Background
play_bg		Color#ffffff
Hover Icon Color
play_color_h		Color#ffffff
Hover Background
play_bg_h		Color#6a11cb
Shadow
play_shadow		Box shadow
Label Typography
label_typo		Typography

Text & Badge

OptionTypeChoices / rangeDefaultNotes
Title Typography
title_typo		Typography
Title Color
title_color		Color#ffffff
Text Typography
desc_typo		Typography
Text Color
desc_color		Colorrgba(255,255,255,0.85)
Text Padding
text_pad		Dimensions
Badge Color
badge_color		Color#ffffff
Badge Background
badge_bg		Colorrgba(16,24,40,0.75)
Below-video Text Color
below_color		Color#101828

Add it with the MCP tools

Any connected agent can place this widget: call add-free-widget with widget_type: "emcp_custom_184" and a settings object using the keys above. Run get-custom-widget with id 184 for the full JSON spec.