Video Widget
The Video widget plays a video file on a page — from the file archive, from an external URL, or as an embedded video from a third-party provider. Use it for instructional videos, presentations, marketing material, or other moving content.
When to use this
- You want to embed a video directly on a page
- The video is in the file archive, on an external URL, or a YouTube/Vimeo embed
- You want autoplay on page load — or let the user start playback
- You want to control the video's size and placement on the page
How it works
The widget supports three sources:
| Source | Description |
|---|---|
| Files | Pull the video from the Files plugin archive. |
| URL | Point directly at an external video file (such as MP4 or WebM). |
| Embedded | Paste embed code (iframe) from a provider like YouTube or Vimeo. |
Add a video
- Enable the Files plugin in the applet's Plugin Settings.
- Open the Design editor for your applet.
- Add the Video widget to the page.
- Open the widget settings.
- Pick Import from — Files, URL, or Embedded.
- Pick a video, enter a URL, or paste iframe code.
- Adjust Size and Position as needed.
- Save your changes.
Widget settings
Source
| Setting | Description |
|---|---|
| Import from | Pick Files, URL, or Embedded. |
| Select video | Opens the file picker against the file archive. Shown when the source is Files. |
| Enter URL | The direct URL to the video file. Shown when the source is URL. Invalid formats are flagged with a warning. |
| Embedded code | Iframe HTML from the video provider. Shown when the source is Embedded. Invalid iframe code is flagged with a warning. |
TIP
Embedded is most common for YouTube and Vimeo since they hand you ready-to-use iframe code straight from their "Share" function. Just paste it as-is.
Size
| Setting | Description |
|---|---|
| Size | Percentage 10–100 in steps of 5. The video's width scales relative to the page width. |
Position
Adjust the video's horizontal placement on the page with the segment control — Left, Center, or Right.
Other
| Setting | Description |
|---|---|
| Autoplay | When on, playback starts automatically when the page loads. Only available for Files and URL sources — embedded videos are controlled by the provider's own settings. |
WARNING
Many mobile browsers block Autoplay with sound. Autoplaying videos usually start muted — the user has to tap to enable sound.
Example
Scenario: You want to embed a YouTube intro video on the home page, centered and at full width.
- Add a Video widget on the home page.
- On YouTube — click Share → Embed and copy the iframe code.
- In the widget, set Import from to Embedded.
- Paste the iframe code into the Embedded code field.
- Set Size to
100%and Position to Center. - Save.
Tips
TIP
For videos in the file archive — keep files in compressed formats (MP4 with H.264) for best compatibility and load time.
TIP
Embedded videos from YouTube and Vimeo have their own player controls and show the provider's player. Use the Files or URL source when you want a clean player without the provider's branding.
Common mistakes
WARNING
Autoplay doesn't appear when the source is Embedded — autoplay for embedded videos is controlled by parameters in the iframe code. Add ?autoplay=1 (or the equivalent) to the embed URL to enable autoplay.
WARNING
If the iframe code from YouTube or Vimeo doesn't work, check that the video is public or unlisted — private videos can't be embedded.
WARNING
External URLs must point at an actual video file (MP4, WebM). Pages with an embedded player don't count — use the Embedded source for those.