> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.ecomx.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Blum Video With Text

**Theme:** Blum · **Section type:** All-template section

The Video with text section shows a video next to a heading, description, and up to 2 buttons. Customers see a thumbnail with a play button and start the video when they want, with sound and player controls. Use it for product demos, tutorials, or brand stories.

> **Note:** You can add this section to any template, except the header and footer.

**What you can do**
- Add the section and your video
- Add a thumbnail and choose how the video plays
- Add the text and buttons
- See what customers see
- Change the layout, colors, and badge
- Fix common problems

---

## Add the section and your video
1. In the theme editor, open the template where you want the section.
2. In the left sidebar, click **Add section** > **Video with text**.
3. Under **Video**, paste a YouTube or Vimeo link in **External video**, or select a **Shopify-hosted video**. If you add both, the Shopify-hosted video is used.
4. Enter a **Video alt text** that describes the video for customers who use screen readers.
5. Choose the **Aspect ratio**: **16:9** or **4:3**.
6. Click **Save**.

## Add a thumbnail and choose how the video plays
1. Under **Video**, select a **Video thumbnail**. Use an image with the same ratio as the video, so it isn't cropped.
2. Turn **Enable video loop** on to replay the video when it ends.
3. Turn **Enable video mute** on to start the video without sound.
4. Click **Save**.

## Add the text and buttons
1. Under **Text**, enter a **Subheading**, **Heading**, and **Description**.
2. Under **Buttons**, enter a **Primary button label** and **Primary button link**. Add a secondary button the same way, or clear a label to hide that button.
3. Under **Layout**, choose the **Content ordering on desktop**: **Video first** or **Text first**.
4. Click **Save**.

## What customers see
- **Before playing:** the thumbnail with a play button. If you don't add a thumbnail, a placeholder image shows.
- **After clicking play:** the video loads in place and starts playing, with the player controls.
- **Desktop:** the video and text sit side by side, in the order you chose.
- **Phones:** the video always shows above the text.

## Settings reference
### General
| Setting | What it does |
| ---- | ---- |
| Color scheme | Sets the colors of the section. Edit schemes in Theme settings > Colors. |
| Enable large heading | Shows the heading in the larger headline size. Useful when the section is the first one on the page. |
| Section background | Sets a background color for the section that replaces the color scheme background. |

### Layout
| Setting | What it does |
| ---- | ---- |
| Content ordering on desktop | Shows the Video first or the Text first on desktop. Phones always show the video first. |

### Video
| Setting | What it does |
| ---- | ---- |
| External video | A YouTube or Vimeo link. |
| Shopify-hosted video | A video you upload to Shopify. It replaces the external video. |
| Video alt text | Describes the video for customers who use screen readers. |
| Aspect ratio | Shapes the video area as 16:9 or 4:3. |
| Video thumbnail | The image shown before customers play the video. Use the same ratio as the video to avoid cropping. |
| Enable video loop | Replays the video when it ends. |
| Enable video mute | Starts the video without sound. |

### Text
| Setting | What it does |
| ---- | ---- |
| Subheading, Heading, Description | The text beside the video. |

### Buttons
| Setting | What it does |
| ---- | ---- |
| Primary button label, Secondary button label | The button text. Leave a label empty to hide that button. |
| Primary button link, Secondary button link | Where the button goes. Appears after you enter the button label. |

### Prominent badge
| Setting | What it does |
| ---- | ---- |
| Text | The badge text. Leave it empty to hide the badge. |
| Accent scheme | Colors the badge with the Main or Extra accent from Theme settings > Colors > Accent. Appears after you enter text. |
| Position | Places the badge on the Left or Right. Appears after you enter text. |
| Shape | Star, Diamond, or Asterisk. Appears after you enter text. |

## Troubleshooting
**My YouTube link doesn't play.**
A Shopify-hosted video replaces the external video. Remove the **Shopify-hosted video** if you want to use the YouTube or Vimeo link.

**The thumbnail is cropped.**
The thumbnail fills the video area. Use an image with the same ratio as the **Aspect ratio** you chose, for example 1920 x 1080 px for 16:9.

**I want the video to play on its own, without a click.**
Video with text waits for a click. For a background video that starts on its own, use **Video banner**.

## Related articles
- [Blum Video Banner](https://doc.ecomx.co/en/article/blum-video-banner-umopmy/)
- [Blum Image With Text](https://doc.ecomx.co/en/article/blum-image-with-text-asff90/)
- [Blum Hero Image With Text](https://doc.ecomx.co/en/article/blum-hero-image-with-text-10ms29c/)
- [Blum Slideshow](https://doc.ecomx.co/en/article/blum-slideshow-8jnt92/)