Video hero

This section was updated in v3.0.0 to use Shopify video, which lets you directly upload a video and alternate mobile video. See our Changelog and theme update guide to learn more.

Add the Video hero section to show a full-width autoplaying video (without sound), uploaded as a .mp4 file to your Shopify files.

If you want to add a Vimeo or YouTube video (with sound), you can use the Video section.

Set up section

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

Editing a template changes all pages that use that template. To edit specific pages, you can create new templates or insert dynamic content with metafields

Add background video

The Video hero section displays an autoplay video (without sound) as the background. After uploading your video, you can select the focal point of your video and add a color overlay.

For autoplay videos, make sure your video files meet the following requirements:

Video file type

.mp4 or .mov Embedded YouTube or Vimeo videos are not supported.

Video length

< 20 seconds (Recommended)

Video size

< 10MB (Recommended)

For theme versions 3.0.0 and later, you can upload a .mp4 video directly in the section settings. For earlier versions, you must upload your video to Content > Files in your Shopify admin, then copy the file link into the section settings.

STEPS (v3.0.0 or later)

In your theme editor (Customize):

  1. Click the Video hero section.

  2. Under Shopify video, click Select video.

    Select a .mp4 video, or click Add videos to upload a .mp4 video file.

  3. (Optional) Under Mobile Shopify video, click Select video for a background video that appears only on mobile devices.

    You may want to upload a video file that has been cropped to a different shape (aspect ratio) to better fit a vertical screen.

  4. Under Media height, choose to display the video with a Custom or the Original height (without cropping).

  5. If Custom height is selected: adjust the Height and Mobile Height of your video between 50% to 100% of the maximum height.

    The Height is the percentage of the window height on your customer's device. When Custom height is set to 50%, the video will always display at half the height of the customer's screen.

  6. Use Media 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.

  7. Click Save.

STEPS (v2.4.0 or earlier)

In your Shopify admin:

  1. Go to Content > Files to open your Shopify files ↗.

  2. Click the Upload files button to add your .mp4 file from your computer.

  3. Once your file has been processed, click the Link icon next to the file to copy the URL.

    You may need to refresh the page for your file to appear.

In the theme editor (Customize):

  1. Click the Video hero section to open the settings.

  2. Paste the link into the Video link field. Click on the the link that appears in the results above.

  3. Click Save.

Click Video hero section to find settings

Setting
Description

Shopify video

Select or upload a video that autoplays (without sound).

Mobile Shopify video

Select or upload an alternate video to show on mobile devices.

Media focal point

For desktop and mobile, specify the main focus of the video. The focal point will remain centered and within frame to avoid unwanted cropping.

Background link

Select a page or URL to make the entire video a clickable link.

Add color overlay

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

Click Video hero section to find settings

Setting
Description

Overlay

Select a color to overlay the image. This option helps provide contrast with text and headings to keep them clear and readable.

Overlay gradient

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 ↗ to learn more.

Overlay opacity

Use the slider to adjust the transparency of the overlay color. Set the opacity to 0% to turn off the overlay color. If set to 100%, the overlay will be opaque.

Add content blocks

Use blocks to customize the content area of the section. Click (+) Add block to add text, buttons, and other media. Use the drag handles ⋮⋮ to re-order blocks, and change the layout in the section settings.

Accent

Add small label heading.

Heading

Add title heading.

Text

Add multiple lines of rich text.

Button

Add buttons with custom styles.

Image

Add images with custom sizes.

Video player

Add video that plays in a popup viewer.

Border

Add divider between blocks.

Spacer

Add space between blocks.

Change content layout

In the section settings, change the position of the content blocks.

Click Video hero section to find settings

Setting
Description

Text position

Change the position of the content blocks within the section for desktop screens.

Mobile text position

Change the position of the content blocks within the section for mobile screens.

Section colors

Change the general colors of the section. Apply a color scheme or use custom colors.

Click Video hero section to find settings

Setting
Description

Text

Select a custom color for the section text.

Buttons

Select a custom color for the section background.

Solid button text

If the Solid button style is selected in the button block settings, select the color for the button text.

Section style

Fine-tune the colors, text position, and padding of the section.

STEPS

In your theme editor (Customize):

  1. Click the Video hero section to open the settings.

  2. Choose to Enable animation to show visual effects when scrolling, hovering, or interacting with the section.

    Learn more about Section animations.

  3. Select a Padding option to change the spacing between sections. Choose between Top and bottom, Top only, Bottom only, or set it to None.

    Note: If the section is place at the top of the page, make sure not to have padding on the top.

  4. Click Save.

Setting
Description

Enable animation

Choose whether to display visual effects when scrolling, hovering, or interacting with the section. See the Animation guide to learn more.

Padding

Add a margin of space around the section to either the Top and bottom, Top only, Bottom only, or set it to None.

Related links

Video section

Last updated