Embed Configuration
Reference for every Ours Privacy video embed option - display mode, engagement, 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 on the Embed tab of a video's detail page; see Embedding videos for the walkthrough and Recipes for worked combinations.
Options
| Option | Label in dashboard | Values | Default |
|---|---|---|---|
| Display mode | Inline player / Popup lightbox | Inline, Popup | Inline |
| Lightbox trigger | Lightbox trigger | Thumbnail, Text link, Time on page, URL parameter | Thumbnail |
| Link text | Link text | Up to 80 characters | Watch video |
| Page delay | Delay in seconds | 1 to 300 | 5 |
| Engagement | Enable engagement | Off, one Email capture, or one CTA | Off |
| Interaction timing | Show when | Before playback, Midpoint, On completion | Before playback |
| Interaction completion | Lock interaction | On, off | Off |
| Player color | Player color | Any hex color, or a brand preset | A default accessible blue |
| Aspect ratio | Aspect ratio | 16:9, 4:3, 21:9, 1:1, 9:16, 3:2 | 16:9 |
| Autoplay | Autoplay | On, off | Off |
| Controls | Show controls | On, off | On |
| Loop | Loop | On, off | Off |
| Structured data | SEO schema | On, off | On |
The options on a page
The same video, embedded four times with different settings. Two things vary, and it is worth keeping them apart:
- Inside the player: the tint and the shape come from Player color and Aspect ratio, and the missing control bar from Show controls. These are the only ways to change the player itself; it renders in an iframe, so your stylesheet cannot reach inside it.
- Around the player: the corner radius, border, shadow, and width in these examples are the host page styling the iframe's own wrapper. That much you control entirely, and it does a lot of the work of making an embed look native to your site.
Brand color. Player Color set to the clinic’s blue, which tints the play button and the control bar. The rounded card and shadow around it are host page CSS.
Display mode
Inline puts the hosted player directly in the page. Visitors use the player controls where the video appears.
Popup opens the same player in a lightbox. The hosted script included in the generated code manages the launch control, timing, and lightbox, so you do not need to add your own modal or iframe trigger.
Popup inherits the video's player color, aspect ratio, controls, loop setting, captions, and analytics behavior. It is useful when you want a video available from a page without reserving the full player area before a visitor chooses to watch.
Visitors can close the lightbox through its close control, its backdrop, or Escape.
Lightbox trigger
Thumbnail renders the selected poster as a focusable play button. It opens with a pointer, Enter, or Space.
Text link renders a normal page link with the text you enter. Selecting it opens the lightbox instead of navigating away. If the lightbox script is blocked or unavailable, the link falls back to opening the hosted player directly.
Time on page opens the lightbox once per browser session after the configured delay. Set a whole number from 1 to 300 seconds. It starts muted and returns focus to the page element the visitor was using when the lightbox opened.
URL parameter opens the lightbox when a visitor arrives through a link containing the video's generated ours-video value. Copy the generated snippet to the destination page, then use the parameter shown in that snippet when building the link. It starts muted.
Use a visitor-controlled launch method for informational video. Delayed and URL-triggered lightboxes interrupt the current page task, so reserve them for a campaign or announcement where the interruption is intentional.
Engagement
Turn on Enable engagement to place one email capture or CTA in the copied standalone embed. Choose a fixed time under Show when, then choose what the visitor sees under Show:
- Email capture asks for one email address and lets you set offer text and the submit-button label.
- CTA shows a headline, button label, and URL.
Lock interaction controls whether the player offers an in-player path to continue or replay without completing the interaction. The setting is copied into the snippet and is not saved to the video, so copy and replace the snippet after every change. See Video Lead Capture for the setup flow, event routing, and current limits.
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
For an Inline embed, turning on autoplay requests playback as soon as the player loads. Inline autoplay starts muted because browsers commonly block unmuted playback without a visitor action. Muted playback is not separately configurable.
For a Popup embed, selecting a Thumbnail or Text link opens the player and requests playback immediately. Because the request follows a visitor action, the player can request audio as well. Time on page and URL parameter start muted because they open without a visitor action.
Autoplay is always a request, not a guarantee. Browsers and operating systems can 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, a start-time parameter, thumbnail previews on the progress bar, multiple interactions in one embed, 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.
- Video Lead Capture: configure an email capture or CTA interaction.
- 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?