The page-opening hero. Content lives in **Hero scene** blocks, each with 25 settings covering media, copy, buttons, and treatment.
Merchant-addable
Yes
Settings
28
Block types
1
File
sections/hero-banner.liquid
Used by default on: Home
Screenshots pending
Captures for Hero banner at desktop and mobile widths are generated from a live store by
npm run shots. They appear here automatically once that has run.
When to use it
The top of the home page, and landing pages.
Setting it up
Add the section as the first item on the template.
Set Section size — this controls the height and whether it runs full-bleed.
Add a Hero scene block and configure its media, heading, and buttons.
Set Motion if you want entrance treatment. It respects the global motion setting and reduced-motion preferences.
Where the content comes from
Blocks own all hero content.
Notes and cautions
As the largest above-the-fold image, the hero is almost always your Largest Contentful Paint element. Upload a properly sized image — the theme handles responsive variants, but it cannot fix a 6 MB source file.
Keep the heading to one line at desktop if you can. Two lines of display type is a lot of screen.
Section settings
Every setting on the section itself, in the order it appears in the theme editor. Group headings
match the editor's own grouping.
Color schemeColor scheme
ID
color_scheme
Default
scheme-1
Section size
Desktop heightSlider
ID
desktop_height
Default
700
Range
480px to 900px, in steps of 20px
Mobile heightSlider
Sets the total height of the mobile hero, including media, content, and navigation.
ID
mobile_height
Default
580
Range
280px to 760px, in steps of 20px
Motion
Enable autoplayCheckbox
ID
autoplay
Default
Off
Autoplay speed (seconds)Slider
ID
autoplay_speed
Default
7
Range
5s to 12s, in steps of 1s
Play background videosCheckbox
ID
play_videos
Default
On
Show scene controlsCheckbox
ID
show_controls
Default
On
Motion control styleDropdown
ID
motion_control_style
Default
Text label
Text labeltext
Pause and play iconicon
Blocks
Blocks are added, reordered, duplicated, and removed inside the section. Each type has its
own settings.
Hero scene scene
Scene layoutDropdown
ID
composition
Default
Full canvas
Full canvascanvas
Media duoduo
Editorial splitstory
Mobile scene design
Mobile scene layoutDropdown
Paired media displays both assets in a media duo. The other layouts focus on primary media.
ID
mobile_layout
Default
Stacked story
Stacked storystacked
Paired mediapaired
Floating notefloating
Overlay text boxoverlay
Overlay positionDropdown
Only applies to the Overlay text box mobile layout.
ID
overlay_position
Default
Middle center
Shown when
mobile_layout is 'overlay'
Top centertop
Middle centermiddle
Bottom centerbottom
Primary media
Primary media typeDropdown
ID
primary_media_type
Default
Image
Imageimage
Videovideo
Primary imageImage
ID
primary_image
Primary videoVideo
ID
primary_video
Secondary media for media duo
Secondary media typeDropdown
ID
secondary_media_type
Default
Video
Imageimage
Videovideo
Secondary imageImage
ID
secondary_image
Secondary videoVideo
ID
secondary_video
Content
EyebrowText
ID
eyebrow
Default
The new collection
HeadingText
ID
heading
Default
Objects for everyday rituals
Body textRich text
ID
body
Default
<p>Thoughtfully made pieces that bring a little more ease to the day.</p>