Handsome documentation

Content and media

Image with text

An image beside text, with optional icons and buttons. The classic brand story section.

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.

Images

SettingWhat it does
Primary imageImageImage
Mobile image (optional)ImageShown on mobile as a fallback for the primary image
Second imageImageUpload a second image to enable the layered two-image layout
Two-image layoutDropdown
OverlapOffset columnsSide by side
Shown only when it applies to the options chosen above.
Image cropDropdownBoth images use the same crop so the pair looks intentional.
Original3:4 (portrait)1:1 (square, cropped)4:3 (landscape)
Shown only when it applies to the options chosen above.
Space between imagesSliderShown only when it applies to the options chosen above.
Image aspect ratioDropdown
Adapt to image1:1 (square, cropped)3:4 (portrait)4:3 (landscape)16:9 (wide)
Shown only when it applies to the options chosen above.
Image shapeDropdown
OriginalSquareRoundedCircle
Image linkLinkShown only when it applies to the options chosen above.

Spinning badge

SettingWhat it does
Show spinning badgeToggleToggle
Badge textTextShort phrases stay readable. Long text has to shrink to fit the circle.Shown only when it applies to the options chosen above.
Badge positionDropdown
Top leftTop rightBottom leftBottom right
Shown only when it applies to the options chosen above.
Badge sizeSliderShown only when it applies to the options chosen above.
Text sizeSliderThe badge repeats the text as many times as fit at this size.Shown only when it applies to the options chosen above.
Spin speedSliderSet to 0 to disable spinningShown only when it applies to the options chosen above.
Text colorColourShown only when it applies to the options chosen above.
Badge backgroundToggleFills the badge with the section colour so it reads over photos.Shown only when it applies to the options chosen above.
Center icon or symbolTextEnter an emoji, symbol, or short textShown only when it applies to the options chosen above.
Center icon sizeSliderShown only when it applies to the options chosen above.

Layout

SettingWhat it does
Image positionDropdown
LeftRight
Reverse layout on mobileToggleToggle
Image column widthDropdown
40%50%60%70%
Column gap (desktop)SliderSlider
Column gap (mobile)SliderSlider
Vertical content alignmentDropdown
TopMiddleBottom
Text alignmentAlignmentAlignment

Spacing

SettingWhat it does
Top paddingSliderSlider
Bottom paddingSliderSlider

Blocks

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

Subheading

SettingWhat it does
TextTextText

Heading

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

Text

SettingWhat it does
TextRich textRich text

Button

SettingWhat it does
LabelTextText
LinkLinkLink
StyleDropdown
PrimaryOutlineText only

Image

SettingWhat it does
ImageImageImage
Image widthSliderSet to 0 to fill the available width.
Image shapeDropdown
OriginalSquareRoundedCircle
LinkLinkLink

Icon with text

SettingWhat it does
IconDropdown
Award / medalBottleBoxBubblesCalendarChat bubbleCheck markCheck mark in circleand 41 more
Custom icon imageImageOverrides the icon above.
Icon sizeSliderSlider
TextTextText