Hero banner

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

  1. Add the section as the first item on the template.
  2. Set Section size — this controls the height and whether it runs full-bleed.
  3. Add a Hero scene block and configure its media, heading, and buttons.
  4. 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>
Content positionDropdown
ID
content_position
Default
Middle left
  • Middle leftmiddle-left
  • Middle centermiddle-center
  • Middle rightmiddle-right
  • Bottom leftbottom-left
  • Bottom rightbottom-right
Content surfaceDropdown
ID
content_surface
Default
Solid
  • Solidsolid
  • Soft glassglass
  • No surfaceplain
Text alignmentDropdown
ID
text_alignment
Default
Left
  • Leftleft
  • Centercenter
Media overlaySlider
ID
overlay_opacity
Default
25
Range
0% to 70%, in steps of 5%

Actions

Primary button labelText
ID
primary_label
Default
Explore the collection
Primary button linkLink
ID
primary_link
Secondary button labelText
ID
secondary_label
Secondary button linkLink
ID
secondary_link