# 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](/lorenza/sections/theme-sections/video-hero.md), [Mosaic grid](/lorenza/sections/theme-sections/mosaic-grid-2-columns.md#add-autoplay-video), and [Image with text](/lorenza/sections/theme-sections/image-with-text.md) sections.
{% endhint %}

## Set up section

Add this section to any template (except Checkout) and use the drag-and-drop handles to re-order its position. You can add this section multiple times with different content and settings.

{% hint style="warning" %}
Editing a template changes all pages that use that template. To edit specific pages, you can [create new templates](/lorenza/general/editing-themes/using-templates.md#create-and-assign-multiple-templates) or [use metafields and dynamic sources](/lorenza/general/adapting-your-theme/dynamic-content-with-metafields.md).
{% endhint %}

<details>

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

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

1. Select a **Template** to edit from the dropdown menu in the top bar.

   > Learn how to use templates in our [Templates guide](/lorenza/general/editing-themes/using-templates.md).
2. Under **Template**, click **(+) Add section** and select **Video**.
3. Click and hold the drag-and-drop handles **`⋮⋮`** to re-order your sections.

</details>

## Add video URL

The **Video** section displays videos hosted on YouTube or Vimeo. Upload a video to YouTube or Vimeo and add the video URL in the theme editor.

<details>

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

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

1. Click on the **Video** block to open the settings.

   ![](/files/Ps86jpItvltTYIBePxPp)
2. Copy and paste your video link from Vimeo or YouTube into the **Video URL** field.

   > Make sure you copy the full URL of your video on YouTube or Vimeo, including **`https://`** at the start.
3. Click **Save**.

</details>

## Add Featured image

You can replace the default video player with a custom preview image and a simple play button. This will keep your page looking sleek and tidy.

![](/files/cyHcoXc1SsEZ39qEh7H4)

<details>

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

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

1. Click on **Video** block to open the settings.
2. Add a **Featured 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.
3. (*Optional*.) Select an **Overlay color** to display overtop of the video and adjust the **Overlay opacity** using the slider.

   > The **Overlay** lets you control the brightness and tone of images. Use this setting to balance it with other images and to increase contrast with headings so they're readable.

   > Set the opacity to **`0%`** to turn off the overlay color; set it to **`100%`** to create a solid color block with no image.
4. (*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.
5. Click **Save**.

</details>

## Section headings

Add a section title and promotional text to your **Video** section. The section headings are included as blocks nested within the section.

<details>

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

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

1. Click the **Small heading** block ("Video") to change the text that appears above the heading.

   > We recommended using the **Small heading** as a label or category such as "Collections" or "Sale".
2. Click the **Heading** block ("Video section") to change the text for the section title.

   > We recommended a short title of just a few words.
3. Click the **Subheading** block to add a few sentences below the heading.

   > We recommend two or three short sentences.
4. Use the **Show/hide** button (eye icon) to remove a heading block.
5. Click **Save**.

</details>

## Add button

Add a **Button** block to link to your collections or products or any other page with a custom label.

<details>

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

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

1. Click **(+)Add block** and select **Button**.
2. Click on the new **Button** block to open the settings panel.
3. Select or paste a URL for the **Link**.
4. Change the **Link text** to display on the button.

   > The most effective button labels ask customers to do something (e.g. Get started, Join us, Shop now). To learn more, [read "What is a Call to Action?"](https://www.thebalancesmb.com/call-to-action-1794380)
5. (*Optional*.) Click and hold the drag handles **`⋮⋮`** to rearrange the blocks:

   ![](/files/cKm7iCMqgcf6VfaAedOf)

   > Click **Remove block** in the block settings to delete a block.

   > Click the **Eye icon** to hide or unhide a block.
6. Click **Save**.

</details>

## Section style and layout

Use the style settings to change the section **Heading alignment** and apply **Contrast section colors**. You can also choose whether to show section **Animations**.

<details>

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

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

1. Click on the **Video** section to open the section settings.
2. (*Optional*.) Use the **Section style** dropdown to apply **Contrast** colors.

   > The **Contrast** style uses the contrast colors selected in your **Theme Settings**.
3. Choose whether to **Enable animation** to show visual effects when scrolling, hovering, or interacting with the section.

   > Learn more about [Section animations](https://fluorescent.co/help/lorenza/theme-settings-animation) in Lorenza.
4. Set the **Heading alignment** to either **Left** or **Center**.

   > This changes the appearance of all of the heading text and button content.
5. Use the **Text max width** slider to control the maximum width of the headings.

   > Use this setting to create a clean visual shape for your text and avoid unwanted line breaks.
6. Click **Save**.

</details>

## Settings reference

Click on the section to find the following settings:

| Setting           | Description                                                                                                    |
| ----------------- | -------------------------------------------------------------------------------------------------------------- |
| Style             | Use the Default or Contrast section style. The Contrast style uses the contrast colors in your Theme Settings. |
| Enable animation  | Choose whether to show visual effects when scrolling, hovering, or interacting with the section.               |
| Heading alignment | Position the headings and button to the left or center of the section.                                         |
| Max width of text | Use the slider to control the maximum width and line breaks of the headings                                    |

Click on the **Video block** to find the following settings:

| Setting         | Description                                                                                                                                                                                                         |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Video URL       | Add the full URL to your video on YouTube or Vimeo, including https\:// at the start.                                                                                                                               |
| Featured image  | Select or upload an image as a preview to overlay the video player.                                                                                                                                                 |
| Overlay color   | Choose the color that overlays the video preview or custom image overlay.                                                                                                                                           |
| Overlay opacity | <p>Use the slider to change the transparency of the overlay color, from 0% (off) to 100% (solid).<br><br>Use this setting to change the tone of your image and increase contrast with text to make it readable.</p> |
| Small heading   | Enter text to display as a small heading above the section title                                                                                                                                                    |
| Heading         | Enter heading text to display as a section title.                                                                                                                                                                   |
| Subheading      | <p>Enter subheading text to display below the heading.<br><br>Use formatting buttons to add bold, italic, or link text.</p>                                                                                         |

\\

***

> **Related links**
>
> [Video hero](/lorenza/sections/theme-sections/video-hero.md)


---

# 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://help.fluorescent.co/lorenza/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.
