Handsome documentation

Home page sections

Slideshow

Full-width slides with text, buttons, product cards and hotspots. Autoplay, arrows and dots are all optional.

Tips

  • Upload a separate mobile image for each slide when the desktop picture is wide. Tall phone images make a much better first impression.
  • While you edit a slide in the theme editor, the slideshow stays on that slide and pauses autoplay.
  • Three to four slides is plenty. The first slide does most of the work.

Settings

Section width

SettingWhat it does
WidthDropdown
Full widthCustom width

Display and height

SettingWhat it does
Desktop heightDropdown
Full screenExtra largeLargeMediumSmallOriginal (image height)
Mobile heightDropdown
Full screenExtra largeLargeMediumSmallOriginal (image height)
SettingWhat it does
Show dots on desktopToggleToggle
Show dots on mobileToggleToggle
Dot colorColourShown only when it applies to the options chosen above.
Show arrows on desktopToggleToggle
Show arrows on mobileToggleToggle
Arrow shapeDropdown
CircleSquare
Shown only when it applies to the options chosen above.
Arrow icon colorColourShown only when it applies to the options chosen above.
Arrow background colorColourShown only when it applies to the options chosen above.
Background opacitySliderShown only when it applies to the options chosen above.

Autoplay

SettingWhat it does
Enable autoplayToggleToggle
Autoplay speed (seconds)SliderShown only when it applies to the options chosen above.
Pause on hoverToggleShown only when it applies to the options chosen above.
Transition effectDropdown
SlideFade
Loop slidesToggleToggle

Hotspot slides

SettingWhat it does
Icon styleDropdown
Plus iconDot
AnimationDropdown
PulseBlinkStatic
Name tagsDropdownShows the name beside each marker.
All screensDesktop onlyOff

Spacing

SettingWhat it does
Top paddingSliderSlider
Bottom paddingSliderSlider

Blocks

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

Slide

Media

SettingWhat it does
Desktop imageImageImage
Mobile imageImageImage
Video URLTextPaste a YouTube, Vimeo, or direct .mp4 URL
Mobile fallback imageImageShown on mobile instead of video (YouTube/Vimeo only)

Content

SettingWhat it does
SubheadingTextText
HeadingTextText
DescriptionRich textRich text
Heading sizeDropdown
H1 — largestH2 — mediumH3 — small
Content positionDropdown
Top leftTop centerTop rightMiddle leftMiddle centerMiddle rightBottom leftBottom centerBottom right
Text alignmentAlignmentAlignment

Button 1

SettingWhat it does
LabelTextText
LinkLinkLink
StyleDropdown
PrimaryOutlineText only

Button 2

SettingWhat it does
LabelTextText
LinkLinkLink
StyleDropdown
PrimaryOutlineText only

Button size

SettingWhat it does
Button sizeDropdownLarge makes it one step bigger than the store's button size.
StandardLarge

Color scheme

SettingWhat it does
Color schemeColour schemeColour scheme

Overlay

SettingWhat it does
Enable overlayToggleToggle
Overlay colorColourShown only when it applies to the options chosen above.
Overlay opacitySliderShown only when it applies to the options chosen above.

Content box background

SettingWhat it does
Enable backgroundToggleToggle
Background colorColourShown only when it applies to the options chosen above.
Background opacitySliderShown only when it applies to the options chosen above.

Tagged product

SettingWhat it does
ProductProductShows a small product card on this slide.
Card positionDropdown
Bottom leftBottom centerBottom right
Shown only when it applies to the options chosen above.
Color schemeColour schemeShown only when it applies to the options chosen above.
Small label above the titleDropdown
NoneProduct typeVendor
Shown only when it applies to the options chosen above.
Show priceToggleShown only when it applies to the options chosen above.
Show add to cart buttonToggleProducts with more than one variant link to the product page instead.Shown only when it applies to the options chosen above.
On mobileDropdownOn a phone the card sits under the slide's buttons.
Full cardCompact stripHidden
Shown only when it applies to the options chosen above.

Hotspot slide

SettingWhat it does
Desktop imageImageImage
Mobile imageImageOptional. Falls back to the desktop image if not set.
Show hotspots on mobileToggleToggle
Move hotspots on mobileToggleSet separate positions for phones.Shown only when it applies to the options chosen above.

Content

SettingWhat it does
SubheadingTextText
HeadingTextText
DescriptionRich textRich text
Heading sizeDropdown
H1 — largestH2 — mediumH3 — small
Content positionDropdown
Top leftTop centerTop rightMiddle leftMiddle centerMiddle rightBottom leftBottom centerBottom right
Content position on mobileDropdown
Same as desktopTop leftTop centerTop rightMiddle leftMiddle centerMiddle rightBottom leftBottom centerBottom right
Text alignmentAlignmentAlignment

Button label

SettingWhat it does
LabelTextText
LinkLinkLink
StyleDropdown
PrimaryOutlineText only
Button sizeDropdownLarge makes it one step bigger than the store's button size.
StandardLarge

Color scheme

SettingWhat it does
Color schemeColour schemeColour scheme

Overlay

SettingWhat it does
Enable overlayToggleToggle
Overlay colorColourShown only when it applies to the options chosen above.
Overlay opacitySliderShown only when it applies to the options chosen above.

Hotspot 1

SettingWhat it does
ProductProductProduct
Horizontal positionSliderShown only when it applies to the options chosen above.
Vertical positionSliderShown only when it applies to the options chosen above.
Horizontal position on mobileSliderShown only when it applies to the options chosen above.
Vertical position on mobileSliderShown only when it applies to the options chosen above.

Hotspot 2

SettingWhat it does
ProductProductProduct
Horizontal positionSliderShown only when it applies to the options chosen above.
Vertical positionSliderShown only when it applies to the options chosen above.
Horizontal position on mobileSliderShown only when it applies to the options chosen above.
Vertical position on mobileSliderShown only when it applies to the options chosen above.

Hotspot 3

SettingWhat it does
ProductProductProduct
Horizontal positionSliderShown only when it applies to the options chosen above.
Vertical positionSliderShown only when it applies to the options chosen above.
Horizontal position on mobileSliderShown only when it applies to the options chosen above.
Vertical position on mobileSliderShown only when it applies to the options chosen above.

Hotspot 4

SettingWhat it does
ProductProductProduct
Horizontal positionSliderShown only when it applies to the options chosen above.
Vertical positionSliderShown only when it applies to the options chosen above.
Horizontal position on mobileSliderShown only when it applies to the options chosen above.
Vertical position on mobileSliderShown only when it applies to the options chosen above.

Hotspot 5

SettingWhat it does
ProductProductProduct
Horizontal positionSliderShown only when it applies to the options chosen above.
Vertical positionSliderShown only when it applies to the options chosen above.
Horizontal position on mobileSliderShown only when it applies to the options chosen above.
Vertical position on mobileSliderShown only when it applies to the options chosen above.