Handsome documentation

Home page sections

Video scroll

Shoppable short videos as expanding panels, each linked to a product.

Settings

Section width

SettingWhat it does
WidthDropdown
Full widthDefaultCustom width
Custom widthSliderShown only when it applies to the options chosen above.

Color scheme

SettingWhat it does
Use the store's default color schemeToggleToggle
Color schemeColour schemeShown only when it applies to the options chosen above.

Section header

SettingWhat it does
SubheadingTextText
HeadingTextText
DescriptionRich textRich text
Heading sizeDropdown
H1 — largestH2 — mediumH3 — small
Text alignmentAlignmentAlignment

Video display

SettingWhat it does
Gap between videosSliderSlider

Panels

SettingWhat it does
Layout on desktopDropdown
GridScroll
Videos per rowSliderUse a half to show part of the next video.
Layout on mobileDropdown
GridScroll
Videos per row on mobileDropdown
11.52
Show navigation arrowsToggleShown only when it applies to the options chosen above.
Show arrows on mobile sliderToggleShown only when it applies to the options chosen above.
Curve effectToggleCards tilt toward the center as the row scrolls. Turns off snapping.Shown only when it applies to the options chosen above.
Card shapeDropdown
Vertical 9:16Portrait 3:4Portrait 4:5Square 1:1Fixed height
Video heightSliderShown only when it applies to the options chosen above.
Video height on mobileSliderShown only when it applies to the options chosen above.
Video cornersDropdown
SquareRounded

Playback

SettingWhat it does
AutoplayToggleToggle
Play on hoverTogglePlays when a panel opens, stops when it closes. Off leaves the cover up.
Loop videoToggleToggle
Start mutedToggleToggle
Show mute/unmute buttonToggleToggle
Pause others when one playsToggleOnly one video plays at a time

Shop this video

SettingWhat it does
Rotate products on the barToggleToggle

Video player

SettingWhat it does
Open videos in a full-screen playerToggleA carousel on desktop and a swipe feed on mobile.

Spacing

SettingWhat it does
Top paddingSliderSlider
Bottom paddingSliderSlider

Blocks

Blocks are the pieces you add, remove and reorder inside the section, under Add block.

Video

Video source

SettingWhat it does
Shopify-hosted videoVideoTakes priority over YouTube/Vimeo URL if both are set
YouTube or Vimeo URLVideo linkYouTube or Vimeo only. TikTok and Reels cannot be embedded — upload the file.
Cover / thumbnail imageImageShown before the video plays and on mobile where autoplay is restricted

Content

SettingWhat it does
Video titleTextText
Short descriptionTextText
SettingWhat it does
Link URLLinkLink

Shop this video

SettingWhat it does
ProductsProductsShown as a bar across the foot of the video. Up to 12.

Button below video

SettingWhat it does
Show buttonToggleToggle
LabelTextShown only when it applies to the options chosen above.
StyleDropdown
PrimaryOutlineText only
Shown only when it applies to the options chosen above.