Handsome documentation

Collections and search

Collection

The collection page: a banner, an optional subcollections bar and the product grid with filters and sorting.

Filters

Filters come from Shopify's Search & Discovery app. See the filters guide for setup.

Subcollections bar

The bar shows links taken from a menu, so it can follow your main menu's structure. It can sit above the grid or inside the banner.

Settings

Layout

SettingWhat it does
Default page widthDropdown
Full widthDefaultCustom
Custom width (px)SliderShown 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.

Filters

SettingWhat it does
Show filtersToggleToggle
Layout styleDropdown
Left sidebarDrawer
Shown only when it applies to the options chosen above.
Sidebar widthSliderShown only when it applies to the options chosen above.
Show active filter tagsToggleShown only when it applies to the options chosen above.
Show clear all buttonToggleShown only when it applies to the options chosen above.
Show product count per filterToggleShown only when it applies to the options chosen above.
Collapse filter groups by defaultToggleShown only when it applies to the options chosen above.
Max visible options per groupSliderShown only when it applies to the options chosen above.

Filter display styles

SettingWhat it does
Price filter styleDropdown
SliderMin / max inputs
Shown only when it applies to the options chosen above.
Color filter styleDropdown
Color swatchesCheckboxes
Shown only when it applies to the options chosen above.
Size filter styleDropdown
ButtonsCheckboxes
Shown only when it applies to the options chosen above.
Other filter styleDropdown
CheckboxesDropdown
Shown only when it applies to the options chosen above.
Show active filter count on buttonToggleShown 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.

Subcollections bar

Display

SettingWhat it does
PlacementDropdownInside the banner, the bar sits above the title in the banner's text color.
Its own rowInside the collection banner
Navigation menuMenuShows the collections nested under the one being viewed. Collections only.
Show the parent collectionToggleAdds the collection above as the first item, when it is a collection.
Display styleDropdown
Text linksPill buttonsImage with text
Highlight active subcollectionToggleToggle
AlignmentDropdown
LeftCenterRight
Gap between itemsSliderSlider
Enable horizontal scrollToggleToggle

Image with text settings

SettingWhat it does
Image widthSliderShown only when it applies to the options chosen above.
Image shapeDropdown
CircleSquareRounded square
Shown only when it applies to the options chosen above.
Show subcollection nameToggleShown only when it applies to the options chosen above.
Show border on active itemToggleShown only when it applies to the options chosen above.

Mobile

SettingWhat it does
Enable horizontal scroll on mobileToggleToggle
Show scroll arrows on mobileToggleToggle
Mobile color schemeColour schemeColour scheme

Collection banner

Display

SettingWhat it does
Show collection bannerToggleToggle
Show breadcrumbsToggleToggle
Title alignmentDropdown
LeftCenter
Shown only when it applies to the options chosen above.
Image sourceDropdownCollections with no image of their own use the custom image.
Collection image, then customCustom image only

Custom image

SettingWhat it does
Desktop imageImageImage
Mobile imageImageImage
Focal pointDropdown
CenterTopBottomLeftRight
SettingWhat it does
Desktop heightDropdown
Full screen (100vh)Extra large (80vh)Large (60vh)Medium (50vh)Small (40vh)Original (auto)
Mobile heightDropdown
Full screen (100vh)Extra large (80vh)Large (60vh)Medium (50vh)Small (40vh)Original (auto)

Content overlay

SettingWhat it does
Content positionDropdown
Top leftTop centerTop rightMiddle leftMiddle centerMiddle rightBottom leftBottom centerBottom right
Show collection titleToggleToggle
Show collection descriptionToggleToggle
Description character limitSliderSet to 0 for no limit
Show product countToggleToggle
Banner color schemeColour schemeText and overlay on the image. Pick a dark scheme for dark photosShown only when it applies to the options chosen above.
Overlay opacitySliderShown only when it applies to the options chosen above.

Product grid

Layout

SettingWhat it does
Columns on desktopDropdown
2345
Columns on mobileDropdown
12
Row gapSliderSlider

Pagination

SettingWhat it does
Products per pageSliderSlider
Pagination styleDropdown
Page numbersLoad more button

Sort

SettingWhat it does
Show sortToggleToggle
Sort optionsDropdownWhich orders shoppers can choose from.
RecommendedAll
Shown only when it applies to the options chosen above.

Toolbar

SettingWhat it does
Show how many productsToggleToggle
Show view toggleToggleToggle