Handsome documentation

Header and footer

Header

Logo, main menu, search, account and cart. Add mega menus, menu highlights and a header button as blocks.

Setting up the menu

  1. In Shopify admin, go to Content → Menus and build your main menu. Second-level items become dropdown columns, third-level items become links inside them.
  2. In the theme editor, open Header and pick that menu.
  3. To turn a top-level item into a rich panel, add a Mega menu block and type the menu item's name in it. See the mega menu guide.

Highlights and the header button

  • Menu highlight styles one menu item: a badge such as New or Sale, a colour, or an underline.
  • Button adds a call to action next to the icons, for example Shop the edit.
Transparent header

On the home page the header can sit over your first slide or banner. Upload a light Transparent header logo so it stays readable over photos.

Settings

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
Header widthDropdown
ContainedFull width
LayoutDropdown
Logo left, menu centerLogo center, menu leftLogo center, menu belowLogo center, drawer menu
SettingWhat it does
MenuMenuMenu
Add a block below, then set its "For item" to a top-level menu item.
Menu hover effectDropdown
None (subtle fade)UnderlineBackground
Bold on hoverToggleToggle

Style

SettingWhat it does
Header behaviorDropdown
StaticStickySticky (hide announcement on scroll)
Transparent headerToggleHome page only. Every other page keeps the normal header.
Transparent header text colorColourShown only when it applies to the options chosen above.
SettingWhat it does
Desktop logoImageImage
Mobile logoImageImage
Transparent header logoImageShown only when it applies to the options chosen above.
Store nameTextShown instead of a logo when no logo image is set.
Desktop logo widthSliderSlider
Mobile logo widthSliderSlider

Icons

SettingWhat it does
Show search iconToggleToggle
Show account iconToggleToggle
Show cart iconToggleToggle
Show cart totalToggleShows the running total beside the icon. Hidden below 750px.Shown only when it applies to the options chosen above.
Icon sizeDropdown
MediumSmall

Hamburger menu

SettingWhat it does
Icon sizeSliderSlider
PaddingSliderSlider
Show backgroundToggleToggle
Background colorColourShown only when it applies to the options chosen above.
Menu icon colorColourShown only when it applies to the options chosen above.
Corner radiusSliderShown only when it applies to the options chosen above.

Mobile drawer

SettingWhat it does
Secondary menuMenuMenu
Show search iconToggleToggle
Show account iconToggleToggle
Show social iconsToggleToggle
Drawer animation speedDropdown
SlowMediumFast

Spacing

SettingWhat it does
Desktop top and bottom paddingSliderSlider
Mobile top and bottom paddingSliderSlider

Blocks

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

Mega menu

SettingWhat it does
For itemTextType the exact name of a top-level menu item to attach this mega menu to it.
LayoutDropdownChoose what appears beside the menu columns.
Links onlyLinks with collection imagesBannerDropdown list with imageProductsCollectionsBlog postsCustom HTML
ContainerDropdownSet the width of the content wrapper.
Use header's containerFull width

Column images

Uses each linked collection's own image. Set it in Products > Collections.

SettingWhat it does
Image shapeDropdown
WideLandscapeSquarePortrait
Shown only when it applies to the options chosen above.
Shop all button labelTextLeave blank to use "Shop all" with the menu item name.Shown only when it applies to the options chosen above.
Shop all button linkLinkLeave blank to link to the menu item itself.Shown only when it applies to the options chosen above.
SettingWhat it does
Banner styleDropdown
Content belowContent over image
Shown only when it applies to the options chosen above.
Banner imageImageShown only when it applies to the options chosen above.
Banner linkLinkShown only when it applies to the options chosen above.
TitleTextShown only when it applies to the options chosen above.
SubtitleTextShown only when it applies to the options chosen above.
Button labelTextShown only when it applies to the options chosen above.
HeadingTextShown above the products, collections or blog posts.Shown only when it applies to the options chosen above.
Custom HTMLHTMLShown only when it applies to the options chosen above.

Content sources

SettingWhat it does
ProductsProductsUsed by the Products layout.
CollectionsCollectionsUsed by the Collections layout.
BlogBlogUsed by the Blog posts layout.

Menu highlight

SettingWhat it does
For itemTextType the exact name of any menu item, at any level, to highlight it.
Highlight styleDropdown
BadgeHand-drawn circleHand-drawn underline

Badge

SettingWhat it does
Badge textTextShown only when it applies to the options chosen above.
Badge shapeDropdown
PillSquareFlag
Shown only when it applies to the options chosen above.
Badge positionDropdownApplies on desktop. In the mobile menu the badge always sits beside the item.
Above the menu itemBeside the menu item
Shown only when it applies to the options chosen above.
Badge fillDropdown
FilledOutline
Shown only when it applies to the options chosen above.
Badge colorColourShown only when it applies to the options chosen above.
Badge text colorColourShown only when it applies to the options chosen above.
Badge font sizeSliderShown only when it applies to the options chosen above.

Hand-drawn mark

SettingWhat it does
Sketch styleDropdown
Single strokeDouble strokeLoose loop
Shown only when it applies to the options chosen above.
ColorColourShown only when it applies to the options chosen above.
ThicknessSliderShown only when it applies to the options chosen above.
Draw animationDropdownApplies on desktop. In the mobile menu the mark is always drawn.
No animationDraw on page loadDraw on hover
Shown only when it applies to the options chosen above.

Button

SettingWhat it does
Button labelTextText
Button linkLinkLink
StyleDropdownColors come from the header color scheme.
PrimaryOutlineText only
Attention effectDropdownA looping animation for a sale or promotion. Use on one button only.
NoneGlowPulseShine