Handsome documentation

Product page

Product

The main product page: gallery and product details. Every part of the details column is a block you can add, remove and reorder.

Building the product page

In the theme editor, open a product template and select Product. The left side is the gallery; the right side is a stack of blocks.

A typical order is Breadcrumb, Vendor, Title, Rating, Price, Variant selector, Quantity selector, Add to cart, Shipping info, Collapsible rows.

Different templates for different products

Create extra product templates (for example product.bundle) and assign them in the product's admin page under Theme template.

Settings

Layout

SettingWhat it does
Page widthDropdown
Full widthDefaultCustom
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.

Columns

SettingWhat it does
Column gapSliderSlider
Media positionDropdown
LeftRight
Sticky product infoToggleProduct info column stays fixed while you scroll
Sticky mediaToggleMedia column stays fixed while product info scrolls
SettingWhat it does
Layout styleDropdown
Standard (main + thumbnails)Stacked2-column grid3-column gridMixed (large + grid)Two per row

Thumbnails

SettingWhat it does
Thumbnail positionDropdown
BelowLeftRight
Shown only when it applies to the options chosen above.
Thumbnail sizeSliderShown only when it applies to the options chosen above.

Image settings

SettingWhat it does
Image ratioDropdownSquare fits the whole photo in a square frame without cropping it.
SquareOriginal
Enable zoomToggleLets a shopper click the enlarged photo to magnify and pan it.Shown only when it applies to the options chosen above.
Enable lightboxToggleToggle
Show navigation arrowsToggleToggle

Mobile media

On phones every layout shows one image at a time, swipeable.

SettingWhat it does
NavigationDropdown
DotsThumbnailsNone

Sticky add to cart

SettingWhat it does
Show sticky barToggleToggle
Sticky bar color schemeColour schemeShown only when it applies to the options chosen above.

Collapsible rows

SettingWhat it does
Row styleDropdown
UnderlinedBoxedCard
MarkerDropdown
Plus and minusArrowChevron
Allow several rows open at onceToggleToggle

Padding

SettingWhat it does
Top paddingSliderSlider
Bottom paddingSliderSlider

Blocks

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

Add to cart

SettingWhat it does
Add to cart styleDropdown
PrimaryOutlineText only
Button sizeDropdown
SmallMediumLarge
Attention animationDropdownA slow loop to draw the eye. Stops while the button is working.
NoneShineGlowPulse
Show dynamic checkout buttonsToggleShop Pay, Apple Pay and other express options. Not shown for gift cards.
Buy it now styleDropdownUsed when no express checkout option is available.
PrimaryOutlineText only
Shown only when it applies to the options chosen above.

Pre-order

SettingWhat it does
Tag a product with the tag below and its Add to cart becomes Pre-order.
Pre-order tagTextProducts with this tag show the Pre-order button instead of Add to cart.

Ask about product

SettingWhat it does
Button labelTextText
Button styleDropdown
OutlinePrimaryText only
Modal titleTextText

Breadcrumb

SettingWhat it does
Show collectionToggleToggle
Separator styleDropdown
Arrow (›)Slash (/)Dot (·)

Collapsible row

SettingWhat it does
HeadingTextText
Show product descriptionToggleShown above the content below.
ContentRich textRich text
Open by defaultToggleToggle
Heading iconDropdown
NoneAwardBottleBoxBubblesCalendarChat bubbleCheckand 40 more
Custom iconImageReplaces the icon above.

Complementary products

SettingWhat it does
Section headingTextText
Number of productsSliderSlider
Show combined priceToggleToggle
Show add all buttonToggleToggle
Button labelTextShown only when it applies to the options chosen above.

Custom Liquid

SettingWhat it does
Liquid codeLiquidLiquid

Custom text

SettingWhat it does
ContentRich textRich text
Text alignmentDropdown
LeftCenterRight

Customer input field

SettingWhat it does
LabelTextAlso the name on the order. Without one the field is hidden.
Field typeDropdown
TextMulti-line textDropdownCheckboxDateNumber
Dropdown choicesTextOne per line, or separated by commas.Shown only when it applies to the options chosen above.
PlaceholderTextShown only when it applies to the options chosen above.
Require an answerToggleToggle
Character limitSlider0 for no limit.Shown only when it applies to the options chosen above.
Helper textTextText

Extra button

SettingWhat it does
LabelTextText
LinkLinkLink
StyleDropdown
PrimaryOutlineText only
Show an iconToggleToggle
IconDropdown
AwardBottleBoxBubblesCalendarChat bubbleCheckCheck markand 39 more
Shown only when it applies to the options chosen above.
Icon positionDropdown
LeftRight
Shown only when it applies to the options chosen above.

Icon with text

SettingWhat it does
Icon positionDropdown
HorizontalVertical
Icons per rowDropdown
234

Item 1

SettingWhat it does
HeadingTextLeave the heading and description empty to skip this item.
DescriptionTextText
IconDropdown
AwardBottleBoxBubblesCalendarChat bubbleCheckCheck markand 39 more
Icon sizeSliderSlider

Item 2

SettingWhat it does
HeadingTextLeave the heading and description empty to skip this item.
DescriptionTextText
IconDropdown
AwardBottleBoxBubblesCalendarChat bubbleCheckCheck markand 39 more
Icon sizeSliderSlider

Item 3

SettingWhat it does
HeadingTextLeave the heading and description empty to skip this item.
DescriptionTextText
IconDropdown
AwardBottleBoxBubblesCalendarChat bubbleCheckCheck markand 39 more
Icon sizeSliderSlider

Item 4

SettingWhat it does
HeadingTextLeave the heading and description empty to skip this item.
DescriptionTextText
IconDropdown
AwardBottleBoxBubblesCalendarChat bubbleCheckCheck markand 39 more
Icon sizeSliderSlider

Image

SettingWhat it does
ImageImageImage
WidthSliderSet to 0 to use original image size
LinkLinkLink
AlignmentDropdown
LeftCenterRight

Image upload field

SettingWhat it does
Field labelTextText
Accept JPG/JPEGToggleToggle
Accept PNGToggleToggle
Accept PDFToggleToggle
Max file sizeSliderSlider
Helper textTextText
Required fieldToggleToggle

Inventory status

SettingWhat it does
Display styleDropdown
Simple textDetailed countIndicator dot
In stock textTextText
Low stock textTextUse {count} where the number in stock should appear.
Out of stock textTextText
Low stock thresholdSliderSlider

Price

SettingWhat it does
Show savings badgeToggleToggle
Savings formatDropdown
Fixed amountPercentageBoth
Shown only when it applies to the options chosen above.
Price font sizeSliderSlider
Show tax infoToggleShown only when your prices include tax.
Tax info textTextShown only when it applies to the options chosen above.

Product tags

SettingWhat it does
Display styleDropdown
PillPlain textLinked
AlignmentDropdown
LeftCenterRight

Quantity selector

SettingWhat it does
StyleDropdown
BoxedMinimal

Rating

SettingWhat it does
Show review countToggleToggle
Link count to reviews sectionToggleToggle

Share buttons

SettingWhat it does
Share labelTextText

Platforms

SettingWhat it does
Show FacebookToggleToggle
Show X (Twitter)ToggleToggle
Show PinterestToggleToggle
Show WhatsAppToggleToggle
Show copy linkToggleToggle

Style

SettingWhat it does
Display styleDropdown
Icons onlyIcons with name
Icon sizeSliderSlider

Shipping info

SettingWhat it does
Shipping textRich textLeft empty, nothing is shown.
IconDropdown
NoneAwardBottleBoxBubblesCalendarChat bubbleCheckand 40 more
Icon sizeSliderShown only when it applies to the options chosen above.

Delivery

SettingWhat it does
Delivery lineDropdown
NoneCustom textEstimated dates
Delivery textTextShown only when it applies to the options chosen above.
Fastest delivery (business days)SliderShown only when it applies to the options chosen above.
Slowest delivery (business days)SliderShown only when it applies to the options chosen above.
Order cut-off hourSliderStore time, 24-hour. Before it, orders ship today. 0 turns the countdown off.Shown only when it applies to the options chosen above.

Short description

SettingWhat it does
Character limit (0 = no limit)SliderSlider
Show read more linkToggleShown only when it applies to the options chosen above.
Read more labelTextShown only when it applies to the options chosen above.
Read less labelTextShown only when it applies to the options chosen above.

Size guide

SettingWhat it does
Content sourceDropdown
Custom HTMLShopify pageImage
Link labelTextText
HTML contentTextPaste your size chart HTML (tables, styles, etc.)
PagePagePage
Size guide imageImageImage

SKU

SettingWhat it does
SKU labelTextText

Stock countdown

SettingWhat it does
Display styleDropdown
Progress barText onlyBar and text
Low stock thresholdSliderSlider
Countdown textTextUse {count} where the number in stock should appear.
Show when stock is above thresholdToggleToggle

Title

SettingWhat it does
Title sizeDropdownVisual size only. The product title is always the page's main heading.
H1 — largestH2 — mediumH3 — small
Font weightDropdown
LightRegularBold

Trust badges

Badges

SettingWhat it does
Add an image, a label, or both. Empty badges are skipped.
Badge 1 imageImageImage
Badge 1 labelTextText
Badge 2 imageImageImage
Badge 2 labelTextText
Badge 3 imageImageImage
Badge 3 labelTextText
Badge 4 imageImageImage
Badge 4 labelTextText
Badge 5 imageImageImage
Badge 5 labelTextText

Appearance

SettingWhat it does
Badge sizeSliderSlider
AlignmentDropdown
LeftCenterRight
Display styleDropdown
Icons onlyIcons with textText only

Variant selector

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

Vendor

SettingWhat it does
Link to vendor collectionToggleToggle

Pickup availability

SettingWhat it does
Needs local pickup set up in Settings > Shipping and delivery.