> For the complete documentation index, see [llms.txt](https://help.fluorescent.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.fluorescent.co/stiletto/sections/theme-sections/video.md).

# Video

The **Video** section embeds a video uploaded to Shopify, YouTube, or Vimeo. Customers can click to play longer videos with sound about your store and products.

{% hint style="info" %}
For autoplaying background videos (without sound), see the [Video hero](/stiletto/sections/theme-sections/video-hero.md) and [Image with text](/stiletto/sections/theme-sections/image-with-text.md) sections.
{% endhint %}

<div><img src="/files/LSPjppuzvUfM6yIGRpD9" alt=""> <figure><img src="/files/yMrghdmzRiyvIGAPmaQ0" alt=""><figcaption></figcaption></figure></div>

***

{% columns %}
{% column width="58.333333333333336%" %}

#### Set up section

In the editor side panel, click **(+) Add section** and select **Video**. Use the drag handles **`⋮⋮`** to re-order sections.

Click the section to edit general **section styles**, like colors, width, and padding.

{% hint style="info" %}
Editing templates change all pages that use that template. For unique pages, [use new templates](/stiletto/general/editing-themes/using-templates.md#create-and-assign-multiple-templates) or [dynamic metafields](/stiletto/general/adapting-your-theme/dynamic-content-with-metafields.md)
{% endhint %}
{% endcolumn %}

{% column width="41.666666666666664%" %}

#### <mark style="color:$info;">Section style guides</mark>

<table data-view="cards"><thead><tr><th></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><i class="fa-bookmark" style="color:$primary;">:bookmark:</i> <mark style="color:$primary;"><strong>Section colors</strong></mark></td><td></td><td><a href="/pages/ugnuWgDX3bpXquEJrAeA#color-schemes">/pages/ugnuWgDX3bpXquEJrAeA#color-schemes</a></td></tr><tr><td><i class="fa-bookmark" style="color:$primary;">:bookmark:</i> <mark style="color:$primary;"><strong>Section width</strong></mark></td><td></td><td><a href="/pages/nxNcI6zBaofEs4kObMMf#section-width">/pages/nxNcI6zBaofEs4kObMMf#section-width</a></td></tr><tr><td><i class="fa-bookmark" style="color:$primary;">:bookmark:</i> <mark style="color:$primary;"><strong>Padding and divider</strong></mark></td><td></td><td><a href="/pages/nxNcI6zBaofEs4kObMMf#section-padding">/pages/nxNcI6zBaofEs4kObMMf#section-padding</a></td></tr></tbody></table>
{% endcolumn %}
{% endcolumns %}

***

<h2 align="center">Set up video</h2>

***

The **Video** section embeds a video hosted by either Shopify or Youtube and Vimeo. If using Shopify, you can upload and select your video from the theme editor.

For Youtube and Vimeo videos, copy the video URL into theme editor.

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Click on the **Video** section to open the video settings.

   ![](/files/x4FpA4UUyxHMTLYjWvyA)
2. Choose a **Video source**: either **Shopify** or **Youtube or Vimeo**.

   > For **Shopify**: click **Select video** and **Upload video**.

   > For **Youtube or Vimeo**: copy and paste your video link into the **Youtube or Vimeo URL** field. Make sure you copy the full URL, including **https\://** at the start.
3. Click **Save**.

</details>

### <mark style="color:$primary;">Change video style and layout</mark>

{% columns %}
{% column %}
Once you've added your video, you can add a **Cover image**, adjust the shape (**Aspect ratio**), **Focal point**, **Colors**, and the **Text alignment** of the headings and button.
{% endcolumn %}

{% column %} <img src="/files/TV5pUaquafKpDQY8IX2p" alt="" width="375">
{% endcolumn %}
{% endcolumns %}

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Click on the **Video** section to open the video settings.
2. Add a **Cover image** for a preview image that overlays the video with a play button.

   > We recommend using an image from the video. There are no required dimensions. A minimum pixel width of 2500px will ensure optimal quality on the widest screens. [Image settings guide](https://github.com/fluorescent/kb-stiletto/blob/main/theme-sections/general/image-guide/theme-image-settings.md) for more.
3. (*Optional*.) Choose whether to **Loop video** once the video has played to the end.
4. Select the **Aspect ratio** (shape) of your video.
5. Use **Image focal points** to specify the main focus of your images. The focal point of your image will remain centered and within frame when your site adapts to different screen sizes.

   > See our [image guide](/stiletto/general/image-guide/theme-image-settings.md#image-focal-point) to learn more about specifying a focal point for an image used within a section or for an uploaded image file when used anywhere on your site.
6. Select a **Text alignment** for the headings.
7. Change the **Overlay color** and **Overlay opacity** using the slider to increase the contrast between the text and image.

   > These settings help make your text clear and readable.
8. (*Optional*.) Click the **Overlay gradient** option to add a color overlay that fades across a range of hues.

   > You can choose the style, angle, position, and opacity of the gradient. See Shopify's [color gradient guide](https://help.shopify.com/en/manual/online-store/themes/theme-structure/color-scheme#gradients) to learn more.
9. Click **Save**.

</details>

<table><thead><tr><th width="197">Setting</th><th>Description</th></tr></thead><tbody><tr><td>Video source</td><td>Choose to use either a <strong>Shopify</strong> video or <strong>Youtube or Vimeo</strong> embedded video.</td></tr><tr><td>Cover image</td><td>Select or upload an image to overlay the video. We recommend using an image from the video. There are no required dimensions. A minimum pixel width of 2500px will ensure optimal quality on the widest screens.</td></tr><tr><td>Loop video</td><td>Continue to play the video again after it has finished.</td></tr><tr><td>Media aspect ratio</td><td>Crop the shape of the video to <strong>Square</strong>, <strong>Landscape</strong>, or <strong>Portrait</strong>. Choose <strong>Natural</strong> to display the original image shape.</td></tr><tr><td>Media focal point</td><td>Specify the key area of your video. The focal point will remain centered and within frame when your site adapts to different screen sizes.</td></tr><tr><td>Text alignment</td><td>Position the text and headings to the <strong>Left</strong>, <strong>Right</strong>, or <strong>Center</strong>.</td></tr><tr><td>Mobile text alignment</td><td>Position the text and headings for mobile devices to the <strong>Left</strong>, <strong>Right</strong>, or <strong>Center</strong>.</td></tr></tbody></table>

### <mark style="color:$primary;">**Change video play button**</mark>

Customize the **Play button** text, layout and style.

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Click on the ("Watch now") **Play button** block to open the settings.
2. Change the **Button text**. The default text is "Watch now".
3. Select a **Button Layout**. **Full** display the button text and icon with a border around it. **Minimal** displays a single 'play button' icon.
4. Select a **Button icon style**: *Dark*, *Light*, or *Outline*.
5. Click **Save**.

</details>

<img src="/files/Mx0nOcx9q2P8OBOSJchq" alt="" width="375">

### <mark style="color:$primary;">Background image overlay</mark>

The color **overlay** adds a layer of color to your image. Overlays help balance image and text for clarity and readability.

<sub>Click Slide block to find settings</sub>

<table><thead><tr><th width="190">Setting</th><th width="569">Description</th></tr></thead><tbody><tr><td><mark style="color:blue;">Color scheme</mark></td><td>Select color scheme to apply 'Background' or 'Gradient' colors.</td></tr><tr><td><mark style="color:blue;">Overlay opacity</mark></td><td>Use the slider to change the transparency of the overlay. Set the opacity to 0% to turn off the overlay. Set to 100% to display a solid color (instead of the image).</td></tr></tbody></table>

<h2 align="center">Section headings</h2>

***

Add a section title and promotional text to overlay your **Video**. The section headings are included as blocks nested within the section. All 3 blocks include **Size** settings.

Click on one of the text or heading blocks to find the size settings.

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Click on the **Heading** block to enter text for a title.

   > we recommend a short title of just a few words.

   > Change the **Heading size** to **Small**, **Medium**, or **Large**.
2. Click on the **Text** block for a short sentence below the heading.

   > We recommend one or two short sentences that describe the video.

   > Change the **Text size** to **Small**, **Regular**, or **Large**.
3. (*Optional*.) Click **(+) Add block** to add a **Subheading**.

   > Change the **Subheading size** to **Small**, **Medium**, or **Large**.
4. Click **Save**.

</details>

<table><thead><tr><th width="163">Block</th><th>Description</th></tr></thead><tbody><tr><td>Heading</td><td>Enter text to show a heading.</td></tr><tr><td>Subheading</td><td>Enter text to display below the heading.</td></tr><tr><td>Text</td><td>Enter multiple lines of text.</td></tr><tr><td>Play button</td><td>Customize the style of the video play button.</td></tr></tbody></table>

#### Video

***

> **Related links**
>
> [Video hero](/stiletto/sections/theme-sections/video-hero.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 dynamically by asking a question.

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

```
GET https://help.fluorescent.co/stiletto/sections/theme-sections/video.md?ask=<question>
```

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.