External video, Primavera's dedicated section for YouTube or Vimeo videos
This section is specifically for YouTube or Vimeo videos, as opposed to Shopify-hosted videos which can be used in the [Video banner](/sections/video-banner.md) section/block.
External videos are a little harder to work with as you can't force them to a specific aspect ratio without losing access to the controls, so we created a section specifically for such videos.
{% hint style="info" %}
You can also add external videos in the [Rich text](/sections/rich-text.md) and [Rich text columns](/sections/rich-text-columns.md) sections.
{% endhint %}
* **External video link**: Enter the video URL, e.g. `https://www.youtube.com/watch?v=_9VUPq3SxOc`
* **External video poster image:** If you're using an external video, add a poster image. This is displayed before the video is loaded and should match the aspect ratio of the video for better results (the video takes on the same aspect ratio as the poster).
* **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.
* **External video description**: Describe the video for accessibility purposes
* **Layout:**
* **Container type:** See [common settings](/common-settings.md)
* **Button style:** Choose between primary, secondary or text for video controls
{% 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
* Color scheme/Color scheme transition
* Padding
* Borders
{% endhint %}
---
# Agent Instructions: 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:
```
GET https://docs.ultramarinastudios.com/sections/external-video.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.