Skip to main content

Background video

sections/background-video.liquid

Settings​

SettingIDTypeDefaultNotes
Background video plays muted. If you need sound, use a section with a normal video player instead.
Video uploadvideoVideo (Shopify-hosted)Hosted by Shopify. Takes precedence over the external video below.
External videovideo_urlVideo URL (YouTube/Vimeo)Loaded only when the section scrolls into view, so it costs nothing above the fold.
Video descriptionvideo_altTextDescribes the video for screen readers. Leave empty if it is purely decorative.
Cover image
Cover imagecover_imageImageStrongly recommended. Shown while the video loads and whenever autoplay is refused, which happens on low power mode, data saver, and for visitors who ask for reduced motion.
Mobile cover imagecover_image_mobileImageFalls back to the cover image above.
Size
Heightheight_modeDropdownfixedFull screen fills the viewport below the header. The pixel heights below apply only to Fixed. Options: Fixed height, Full screen, Widescreen (16:9).
Desktop heightheight_desktopSlider560Range: 300–900 step 20.
Mobile heightheight_mobileSlider420Range: 240–700 step 20.
Rounded cornersroundedOn/offOff
Text overlay
Text positiontext_positionDropdownmiddle-leftOptions: Top left, Top center, Top right, Middle left, Middle center, Middle right, Bottom left, Bottom center, Bottom right.
Text alignmenttext_alignmentDropdownleftOptions: Left, Center, Right.
Center text on mobilecenter_on_mobileOn/offOn
Style
Text colortext_colorColor#FFFFFF
Tint colortint_colorColor#1B2A1F
Tint opacitytint_opacitySlider35Video frames change constantly, so text needs a tint behind it to stay readable throughout. Range: 0–90 step 5.
Tint gradienttint_gradientColor/gradientReplaces the tint color when set.
Loading
AutoplayautoplayOn/offOnSwitch off to show the cover image until a visitor presses play.
Load the video only when it scrolls into viewlazy_loadOn/offOnKeep this on unless the section is the first thing on the page, where loading immediately gives the video the best chance of autoplaying.
Layout
Make section full widthfull_widthOn/offOn
Top paddingpadding_topSlider0Range: 0–120 step 4.
Bottom paddingpadding_bottomSlider0Range: 0–120 step 4.

Blocks​

Caption (caption)​

SettingIDTypeDefaultNotes
CaptiontextTextBehind the blend

Heading (heading)​

SettingIDTypeDefaultNotes
HeadingheadingTextMade slowly, on purpose
Sizeheading_sizeDropdownlargeOptions: Small, Medium, Large.
Heading tagheading_tagDropdownh2Affects search engines and screen readers, not the size. Options: H1, H2, H3.

Text (text)​

SettingIDTypeDefaultNotes
TexttextRich text<p>A short line about how this is made, or why it is worth the wait.</p>

Buttons (buttons)​

SettingIDTypeDefaultNotes
First button labellabel_1TextWatch the process
First button linklink_1Link
First button stylestyle_1DropdownprimaryOptions: Primary, Secondary, Text.
Open in a new windownew_tab_1On/offOff
Second button labellabel_2Text
Second button linklink_2Link
Second button stylestyle_2DropdownsecondaryOptions: Primary, Secondary, Text.
Open in a new windownew_tab_2On/offOff

Presets​

Available in Add section: Background video