> For the complete documentation index, see [llms.txt](https://docs.ultramarinastudios.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ultramarinastudios.com/blocks/section-blocks/video-banner.md).

# Video banner

<figure><img src="/files/sTnwp2buHG7FJWIpsS32" alt="Video banner with default theme blocks."><figcaption></figcaption></figure>

Whether used as a standalone section or as a mix-and-match block in [split banner](/sections/split-banner.md) or [split card](/sections/split-card.md), the video banner is essentially a video with [theme blocks](broken://pages/WSF8E8s2sEiJqIdxH1ip).

* **Media**: Choose a **desktop video** and, optionally, a **mobile video**
* **Video settings:**
  * **Enable autoplay:** This will autoplay the video when it's in view. If you have concerns about accessibility, we do not recommend enabling this option. Note that by enabling autoplay, your video will be muted. If you need the video to include sound, please disable autoplay.
  * **Play button display**: **Always** display the play button or only display it on **hover/focus**.
  * **Play button style**: Choose between primary, secondary or text for the play button.
  * **Play button alignment**: Choose top left, center or top right for the play button position.
* **Layout**:
  * **Desktop/mobile height**: Choose between **Adapt**, which uses the same aspect ratio as the uploaded image, or one of three fixed sizes, **Small, Medium** and **Large**, for both desktop and mobile.
  * **Stack content**: By default, text content is positioned over the image (the **never** option). When stacked, content will be positioned below the image instead of overlaid. Choose to stack on **mobile** only or **always** to stack on bock desktop and mobile.
  * **Media frame**: Can be used to add a border or frame effect to your image. The background color of this frame inherits from the current color scheme.
  * **Media content padding**: When the text content is overlaid, this setting allows you to choose its spacing from the edge of media. This setting may therefore only be noticeable when the content is aligned to the top/bottom or left/right. **Default** aligns the content to the page width where possible.
* **Colors:**
  * **Enable overlay:** Use this option to improve readability of the text over all screen sizes. Applying a semi-transparent overlay is a great way to ensure both the image and text are visible.
  * **Overlay color**: Choose a linear gradient to apply when the overlay is enabled.

{% hint style="info" %}
Can't find the setting you're looking for?  The following settings are explained in detail in [common settings](/common-settings.md):

* Container type
* Container width
* Horizontal/vertical alignment
* Color scheme/Color scheme transition
* Padding
* Borders
  {% endhint %}

### Blocks

All [theme blocks](broken://pages/WSF8E8s2sEiJqIdxH1ip) are available to use in this section.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ultramarinastudios.com/blocks/section-blocks/video-banner.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
