Embed Configuration
Reference for every Ours Privacy video embed option - player color, aspect ratio, autoplay, controls, loop, and SEO structured data.
Every option available when generating a video embed snippet, with its accepted values and default. Set these in Embed Settings on a video's detail page; see Embedding videos for the walkthrough and Recipes for worked combinations.
Options
| Option | Label in dashboard | Values | Default |
|---|---|---|---|
| Player color | Player Color | Any hex color, or a brand preset | A default accessible blue |
| Aspect ratio | Player Aspect Ratio | 16:9, 4:3, 21:9, 1:1, 9:16, 3:2 | 16:9 |
| Autoplay | Enable autoplay | On, off | Off |
| Controls | Show controls | On, off | On |
| Loop | Loop video | On, off | Off |
| Structured data | Include SEO Schema | On, off | On |
Player color
Applies to the play button, the control bar, and the filled portion of the progress bar. Choose a hex value directly or pick one of your brand presets.
The dashboard checks the chosen color against a WCAG AA 4.5:1 contrast minimum and shows a warning when a combination fails. The player computes a matching foreground and hover shade from the color you set, so only the one value is configurable. See Player accessibility.
Aspect ratio
Sets the shape the player holds as it scales. 16:9 suits most landscape marketing video; 9:16 suits vertical video shot for mobile. The poster image fills the player area and is cropped when its shape differs from the ratio you choose.
The generated snippet is sized for a 16:9 player, so any other ratio shows with empty bars around it inside a widescreen box. To fix the shape, find padding in the first line of the snippet and change its percentage to the one below. It is a one-number edit, and nothing else in the snippet changes:
| Aspect ratio | Padding to use |
|---|---|
16:9 | 56.25% |
4:3 | 75% |
21:9 | 42.86% |
1:1 | 100% |
9:16 | 177.78% |
3:2 | 66.67% |
See Recipes for a worked vertical-video example.
Autoplay
When on, playback starts as soon as the player loads. The player is muted automatically whenever autoplay is on, because browsers block unmuted autoplay. Muted playback is not separately configurable.
Autoplay is a request, not a guarantee: browsers and operating systems can still refuse it, particularly on mobile or when the visitor has data saving enabled.
Controls
When on, the player shows its control bar: play and pause, progress, volume, captions, and fullscreen. When off, the control bar is hidden and the video plays without visible controls.
Turning controls off removes the visitor's ability to pause, mute, or turn on captions, so reserve it for decorative video that is muted, looping, and carries no information the viewer needs. See Player accessibility.
Loop
When on, playback restarts from the beginning each time the video reaches the end.
Looping affects analytics: the player reports one video_complete for the first full pass and stays silent on later passes, so a looping background video does not inflate your engagement numbers with repeated events from a single view. See Video analytics events.
Include SEO Schema
When on, the snippet carries a VideoObject structured data block describing the video's title, description, poster image, upload date, and file URL. The title and description come from the video's fields in the dashboard.
Not currently configurable
The player does not offer playback speed, a quality selector, chapters, a start-time parameter, thumbnail previews on the progress bar, call-to-action overlays, or custom CSS. If you need any of these, use the raw asset URLs with a player of your own; see Building your own player.
Related pages
- Embedding videos: how to generate and place the snippet.
- Recipes: these options combined for common goals.
- Player accessibility: contrast, captions, and keyboard behavior.
- Video analytics events: how playback options affect reported events.
How is this guide?