Handsome documentation

Home page sections

Countdown timer

A countdown to a sale or launch, with a heading, text and button. You choose what happens when it ends.

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.

Layout

SettingWhat it does
Layout styleDropdown
CenteredSplit — heading left, timer rightSplit (reversed) — timer left, heading right
Text alignmentDropdown
LeftCenterRight

Timer settings

SettingWhat it does
End dateTextEnter as YYYY-MM-DD — e.g. 2025-12-31
End timeText24-hour format, e.g. 23:59. Defaults to midnight.
TimezoneDropdown
UTCEastern Time (US)Central Time (US)Mountain Time (US)Pacific Time (US)Brasilia (BRT)Toronto (ET)London (GMT/BST)and 12 more
When timer endsDropdown
Hide sectionShow messageRedirect to URL
Expired messageTextShown only when it applies to the options chosen above.
Redirect URLLinkShown only when it applies to the options chosen above.

Timer display

SettingWhat it does
Display styleDropdown
Solid tilesOutlined tilesFlip cardsNumbers only
Timer sizeDropdown
SmallMediumLarge
Show colons between unitsToggleToggle
UnitsDropdown
Days, hours, minutes, secondsDays, hours, minutesHours, minutes, seconds

Urgency

SettingWhat it does
Highlight in the lastSliderSet to 0 to turn the highlight off.

Background

SettingWhat it does
Background imageImageImage
Mobile background imageImageShown on mobile instead of the desktop background image
Enable color overlayToggleToggle
Overlay colorColourShown only when it applies to the options chosen above.
Overlay opacitySliderShown 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.

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
Button labelTextText
Button linkLinkLink
Button styleDropdown
PrimaryOutlineText only