Header

Sticky header with a cart badge, search overlay, multi-level menus, and a localization form. Built from Logo, Icons, Menu, Country and language, and Menu promotion blocks.

Merchant-addable
Yes
Settings
47
Block types
5
File
sections/header.liquid

Screenshots pending

Captures for Header at desktop and mobile widths are generated from a live store by npm run shots. They appear here automatically once that has run.

When to use it

Every page. It lives in the header section group and cannot be removed.

Setting it up

  1. Edit it from any template — changes apply store-wide.
  2. Add the Logo block and upload your logo. It survives varying aspect ratios.
  3. Add a Menu block and point it at your main menu, created under Content → Menus in Shopify admin.
  4. Add Icons for search, account, and cart.
  5. Add Country and language if you sell in more than one market.
  6. Add a Menu promotion block if you want featured content inside a dropdown.

Where the content comes from

Shopify menus, cart, and localization. Blocks own the arrangement.

Notes and cautions

  • Menus are built in Shopify admin, not here. The block only chooses which menu renders.
  • Dropdowns open on Enter and Space, move through with Tab, and close on Escape returning focus to the launcher.

Section settings

Every setting on the section itself, in the order it appears in the theme editor. Group headings match the editor's own grouping.

Color schemeColor scheme
ID
color_scheme
Default
scheme-1
Header compositionDropdown

Studio bar uses a two-level editorial structure. Split dock appears only above a full-bleed hero or Product stage; every other page uses the solid Fine outline Studio header.

ID
header_composition
Default
Studio bar
  • Studio barstudio
  • Split docksplit-dock
Desktop navigationDropdown

Navigation rail shows the main menu below the brand. Menu drawer keeps the Studio bar to one row.

ID
desktop_navigation
Default
Navigation rail
Shown when
header_composition is not 'split-dock'
  • Navigation railrail
  • Menu drawerdrawer
Mobile brand positionDropdown
ID
mobile_brand_position
Default
Center
  • Startstart
  • Centercenter
Desktop menu presentationDropdown

Choose how the full menu opens from the header.

ID
desktop_menu_presentation
Default
Navigation panel
  • Navigation panelpanel
  • Side drawerside
Mobile menu presentationDropdown

Choose how the full menu opens from the header.

ID
mobile_menu_presentation
Default
Navigation panel
  • Navigation panelpanel
  • Side drawerside
Surface finishDropdown

Controls Studio bar depth and boundaries. Corners follow Theme settings → Layout → Corner style.

ID
surface_finish
Default
Soft shadow
Shown when
header_composition is not 'split-dock'
  • Soft shadowsoft
  • Fine outlineoutline
Brand signatureText

Use a short phrase that complements the logo. Leave blank to hide it.

ID
signature_text
Default
Care, sequenced.
Apply soft shadowCheckbox

Applies the Studio bar soft-shadow treatment to the Split dock surfaces.

ID
split_dock_soft_shadow
Default
On
Shown when
header_composition is 'split-dock'
Show routine linksCheckbox

Choose the Secondary menu in the Menu block to populate this rail. Leave that menu blank to keep the rail hidden.

ID
show_routine_links
Default
Off
Show routine links on mobileCheckbox

Uses the same Secondary menu and maximum link count as the desktop routine rail.

ID
show_mobile_routine_links
Default
On
Routine link headingText
ID
routine_label
Default
Shop by routine
Maximum routine linksSlider

Also limits secondary menu links in mobile navigation.

ID
routine_link_limit
Default
4
Range
2 to 5, in steps of 1
Header behaviorDropdown
ID
header_behavior
Default
Smart sticky on scroll
  • Smart sticky on scrollsticky
  • Always stickyalways
  • Staticnormal
Header background styleDropdown

Solid uses your color scheme. Transparent overlays the first home-page hero. Split dock retains readable floating surfaces over the hero. Every other page stays solid.

ID
header_background_style
Default
Solid
Shown when
header_composition is 'studio'
  • Solidsolid
  • Transparenttransparent
Blur background behind open menusCheckbox

Softly blurs the page behind the menu, dropdowns, search, and country selector while they are open.

ID
background_blur
Default
On

Blocks

Blocks are added, reordered, duplicated, and removed inside the section. Each type has its own settings.

Logo logo_block max 1

Set the logo image and width in Theme settings → Logo. This block controls the shop-name text shown when no logo is set.

Font weightDropdown
ID
title_font_weight
Default
Normal
  • Normal200
  • Bold600
Text transformDropdown
ID
title_text_transform
Default
Capitalize
  • Uppercaseuppercase
  • Capitalizecapitalize
  • Lowercaselowercase

Icons icons_block max 1

Icon style

Icon styleDropdown

Applies to all header icons. They follow your color scheme.

ID
header_icon_style
Default
Outline
  • Outlineoutline
  • Filledfilled
Icon hover effectDropdown
ID
header_icon_hover
Default
Fade
  • Nonenone
  • Fadefade
  • Zoom inscale
  • Lift uplift
  • Tiltrotate
  • Fade + zoomfade-scale
Search iconDropdown
ID
search_icon
Default
Magnifier
  • Magnifiermagnifier
  • Hiddennone
Account iconDropdown
ID
account_icon
Default
Hidden
  • Personperson
  • Person in circleperson_circle
  • Hiddennone
Cart iconDropdown
ID
cart_icon
Default
Basket
  • Bagbag_icon
  • Trolleytrolley_icon
  • Basketbasket_icon

Menu menu_block max 1

MenuMenu
ID
menu
Default
main-menu
Utility menuMenu

Shows links such as Journal, Store locator, Contact, and Help above the mobile panel footer. Split dock can also use these links for its routine rail.

ID
utility_menu
Panel headingText
ID
panel_heading
Default
Menu
Link group columnsDropdown

Controls the desktop layout. Smaller screens adapt automatically.

ID
panel_link_columns
Default
Three
  • Two2
  • Three3
  • Four4
Show account in panelCheckbox

The account link appears only when customer accounts are enabled.

ID
show_account_in_panel
Default
On
Font sizeDropdown
ID
menu_font_size
Default
Small
  • Smalldesktop_menu_small
  • Mediumdesktop_menu_medium
  • Largedesktop_menu_large
Font weightDropdown
ID
menu_font_weight
Default
Light
  • Light300
  • Medium500
  • Bold700
Text transformDropdown
ID
menu_text_transform
Default
Capitalize
  • Uppercaseuppercase
  • Capitalizecapitalize
  • Lowercaselowercase
Menu link hover effectDropdown
ID
menu_hover_style
Default
Underline
  • Nonenone
  • Underlineunderline
  • Fade colorfade
  • Slide underlineslide
Submenu layoutDropdown

Choose how third-level links appear when a menu group has nested items.

ID
submenu_style
Default
Columns
  • Columnscolumns
  • Fly-out panelflyout

Country and language currency_selector max 1

Font styleDropdown
ID
font_style
Default
Regular
  • Regularregular
  • Boldbold
Font sizeDropdown
ID
currency_font_size
Default
Small
  • Smallcurrency_desktop_font_small
  • Mediumcurrency_desktop_font_medium
  • Largecurrency_desktop_font_large
BorderDropdown

Follows your color scheme.

ID
currency_border
Default
None
  • Nonenone
  • Subtlesubtle
  • Solidsolid
Hover effectDropdown
ID
currency_hover
Default
Underline code
  • Nonenone
  • Underline codeunderline
  • Arrow bouncearrow
  • Background highlighthighlight
  • Border brightenborder
  • Lift uplift
Country displayDropdown

What shows in the country selector. Currency follows the selected country.

ID
currency_display
Default
Currency code (USD)
  • Currency code (USD)code
  • Currency symbol ($)symbol
  • Code with symbol (USD $)code_symbol
  • Country name (United States (USD $))name

Menu promotion megamenu

Attach to menu itemText

Enter the exact top-level menu item name. Add more promotion blocks with the same name to create a browsable promotion rail.

ID
menu_item_name
Promotion imageImage
ID
submenu_image
Promotion linkLink
ID
submenu_image_link
Alt textText
ID
submenu_image_alt
Image ratioDropdown
ID
image_ratio
Default
Portrait
  • Portraitportrait
  • Squaresquare
  • Landscapelandscape
EyebrowText
ID
eyebrow
Default
Featured
HeadingRich text (inline)
ID
heading
Default
Discover our collections
SubheadingRich text (inline)
ID
subheading
Default
Explore the finest picks curated just for you.
Link labelText
ID
link_label
Default
Explore