Handsome documentation

Home page sections

Featured product

One product with its gallery, options and buy buttons, so shoppers can buy straight from the home page.

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.

Product

SettingWhat it does
ProductProductProduct

Layout

SettingWhat it does
Media positionDropdown
LeftRight
Media column widthDropdown
40%50%60%70%
Column gapSliderSlider
Reverse layout on mobileToggleToggle

Media settings

SettingWhat it does
Media typeDropdown
Product imagesProduct video
Image aspect ratioDropdown
Adapt to image1:1 (square, cropped)3:4 (portrait)4:3 (landscape)16:9 (wide)
Image shapeDropdown
OriginalSquareRounded
Show thumbnail imagesToggleShown only when it applies to the options chosen above.
Thumbnail positionDropdown
Below main imageLeft sideRight side
Shown only when it applies to the options chosen above.
Enable image zoom on hoverToggleShown only when it applies to the options chosen above.
Enable image lightbox on clickToggleShown only when it applies to the options chosen above.

Spacing

SettingWhat it does
Top paddingSliderSlider
Bottom paddingSliderSlider

Blocks

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

Sale badge

No settings: it shows its content automatically.

Vendor

No settings: it shows its content automatically.

Title

SettingWhat it does
Heading sizeDropdown
H1 โ€” largestH2 โ€” mediumH3 โ€” small

Star rating

No settings: it shows its content automatically.

Price

SettingWhat it does
Show compare at priceToggleToggle

Description

SettingWhat it does
Truncate textToggleToggle
Character limitSliderShown only when it applies to the options chosen above.

SKU

No settings: it shows its content automatically.

Variant selector

SettingWhat it does
Set in Theme settings > Product variants.
Swatch sizeSliderSlider
Swatch shapeDropdownOriginal image ratio leaves variant images uncropped.
CircleSquareOriginal image ratio
Show swatch tooltipToggleToggle

Quantity selector

No settings: it shows its content automatically.

Buy buttons

SettingWhat it does
Show add to cartToggleToggle
Show buy nowToggleToggle

Shipping info

SettingWhat it does
TextRich textRich text

Separator

No settings: it shows its content automatically.

SettingWhat it does
LabelTextLeave empty for "View full details".

Text

SettingWhat it does
ContentRich textRich text

Icon with text

SettingWhat it does
Icon imageImageImage
TextRich textRich text

Collapsible tab

SettingWhat it does
Tab headingTextText
Tab contentRich textRich text

Custom Liquid

SettingWhat it does
Liquid codeLiquidAdd app snippets or other Liquid code to create advanced customizations.