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

# Video

The Video section in the Avante Shopify theme — a YouTube or Vimeo embed behind a cover image that only loads the player when the customer clicks.

The Video section places a YouTube or Vimeo video behind a cover image of your choosing. Nothing from the video platform is loaded until the customer clicks play, so the page stays fast and you control exactly what the still frame looks like instead of accepting the platform's thumbnail.

It is the right section for a brand film, a founder story or a product demo — something the customer chooses to watch, rather than a looping background.

{% hint style="info" %}
**Theme Editor → Add section → Video**
{% endhint %}

***

### How to add

{% stepper %}
{% step %}

### Add the section

In the Theme Editor, click **Add section** and choose **Video**.
{% endstep %}

{% step %}

### Replace the default URL

Paste your own YouTube or Vimeo link into **Video URL**. The field is not empty when the section is added — see below.
{% endstep %}

{% step %}

### Upload the cover images

Add a **Cover image** for desktop and a **Mobile cover image**. This is the still frame customers see before they press play.
{% endstep %}
{% endstepper %}

***

### Good to know

**The section ships with a working demo video already in the field.** **Video URL** has a real YouTube link as its default value, so a Video section added and left alone will play someone else's video on your live storefront. Always replace it.

**YouTube and Vimeo only.** The field does not accept a Shopify-hosted file. For a self-hosted or looping video, use the [Video banner](https://staylime.com/docs/avante-themes/sections/banners/video-banner.md) or a Loop video block in [Media with text](https://staylime.com/docs/avante-themes/sections/media/media-with-text.md).

**The frame is locked to 16:9.** The video area always keeps a 16:9 ratio no matter what shape your cover image is, so a square or portrait cover will be cropped. Export covers at 16:9 and the still will match the video exactly.

**An empty Video URL leaves a dead section, not a hidden one.** The section still takes up its full height and the play button is rendered disabled — it cannot be clicked, and nothing explains why. Clearing the URL is not how you remove the section.

**No cover images at all means a grey placeholder.** With both cover fields empty the theme falls back to its placeholder graphic, including on the live storefront.

**There is no autoplay.** The player is deliberately only loaded on click. That is what keeps YouTube's and Vimeo's scripts off the page until they are needed.

**The Sticky scroll animation does nothing here.** If **Animation → On scroll behavior** is set to Sticky, this section quietly falls back to Static. Parallax and the zoom options do work.

**Video cannot be added to a section group.** It is disabled in the header, footer and overlay groups.

***

### Customization ideas

**Treat the cover as a poster, not a screenshot.** Because you supply the still, it can carry a headline or a play-prompt that the video itself does not have — a designed cover converts better than a paused frame.

**Different crops for different screens.** A wide landscape cover on desktop and a tighter, closer crop on mobile keeps faces and text readable on a phone.

**Put it after the proof, not before it.** A brand film sits well below testimonials or a feature row, where the customer is already interested enough to spend a minute watching.

***

### Related

* [Media overview](https://staylime.com/docs/avante-themes/sections/media.md)
* [Video banner](https://staylime.com/docs/avante-themes/sections/banners/video-banner.md)
* [Media with side tabs](https://staylime.com/docs/avante-themes/sections/media/media-with-side-tabs.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://staylime.com/docs/avante-themes/sections/media/video.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
