Video hero

Theme section

Theme retirement | Context is no longer available on the Shopify theme store. Theme support and updates for current users will end after May 18, 2024. Learn more here.

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

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.

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.


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.

  2. Under Template, click (+) Add section and select Video hero.

  3. Click and hold the drag-and-drop handles ⋮⋮ to re-order your sections.

Add video file

The Video hero section requires an .mp4 that's been uploaded to Content > Files in your Shopify admin. For the best experience, we strongly recommend using a 5 to 10 second video under 10MB.

The autoplay video does not play audio. To embed a video from YouTube or Vimeo with audio, see Context's Video section.

File Format.mp4 video (required)

File size

Maximum 10MB (recommended)


5 - 10 seconds (recommended)


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.

Add section headings

Edit the Heading and Subheading to overlay the video before playing. The section headings are included as blocks nested within the section.


In your theme editor (Customize):

  1. Click the Title block (”Rich text”) to open the settings.

  2. Change the Heading text to display as a section title.

    Increase or decrease the Heading size using the slider.

    Use the Max width of text slider to control the maximum width of the heading.

  3. Click the Subheading block to open the settings.

    Use the formatting buttons to add text styles, links, or lists. To learn more, see Shopify's Rich text editor guide.

    Use the Max width of text slider to control the maximum width of the rich text. Use this setting to create a clean visual shape for your text and avoid unwanted line breaks.

  4. Click Save.

Related links

Video section

Last updated