Header

Configurable Studio bar and Split dock header designs with responsive navigation, search, cart, multi-level menus, localization, and optional menu promotions.

Merchant-addable
Yes
Settings
69
Block types
6
File
sections/header.liquid

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. Choose Header composition, then use Desktop navigation layout to select a visible rail or Menu drawer fallback. The illustrated recipes below provide complete starting points.
  3. Add the Logo block and upload your logo. It survives varying aspect ratios.
  4. Add a Menu block and point it at your main menu, created under Content → Menus in Shopify admin.
  5. Add Icons for search, account, and cart.
  6. Add Country and language if you sell in more than one market.
  7. 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.
  • Navigation rail remains your selected desktop layout. If the primary main menu cannot fit on one line, Studio temporarily uses its compact, one-row Menu drawer without changing the saved setting. Every primary, nested, secondary, and enabled routine link remains available there, and the rail returns automatically when enough space is available.
  • Manifest rechecks the layout after resizing, web-font loading, page load, and theme editor section reloads. If keyboard focus is inside the rail when it collapses, focus moves to the visible Menu button.
  • With JavaScript disabled, navigation wraps instead of clipping. Do not shrink menu text, clip links, or add horizontal scrolling to handle overflow. The Desktop navigation layout setting description also explains the automatic fallback.
  • Dropdowns open on Enter and Space, move through with Tab, and close on Escape returning focus to the launcher.

Header design recipes

Use these recipes as complete starting points. Each one lists the exact Header section and block settings that create the design. The illustrations show the structure; your logo, color scheme, menus, icons, and hero media supply the final character.

Open Online Store → Themes → Customize, then select Header in the header group. Changes made there apply across the store.

Prepare the header once

Before choosing a design:

  1. In Content → Menus, create the menu you want shoppers to use. Top-level links are the primary navigation. Links nested beneath them become secondary and third-level navigation.
  2. In the Header section, add or keep one Logo, one Menu, and one Icons block.
  3. Open the Menu block and set Menu to the menu you created.
  4. Set the logo image and width under Theme settings → Logo. If no image is set, the Logo block displays the shop name and controls its weight and letter case.
  5. Add Country and language only when the store serves multiple markets or languages.
  6. Preview the home page, a product page, a collection page, and a phone width before publishing.

The desktop composition and mobile menu are separate decisions. Finish the desktop recipe first, then complete the mobile setup near the end of this guide.

Choose a design

DesignBest forMain characteristic
Editorial Studio headerBrands that want a visible rail or a closely related compact variationChoose a rail without routines, a rail with routines, or a one-row Menu drawer, then choose Soft shadow or Fine outline
Split dock over a heroCampaigns and highly visual launchesMenu, brand, and utilities float as separate surfaces

Design 1: Editorial Studio header

Choose this when the main menu is part of the brand presentation and shoppers should see the main destinations immediately. Versions A–C use Soft shadow. Versions D–F repeat the same navigation choices with Fine outline.

Transparent preview

Manifest storefront with a transparent editorial navigation rail and no routine links

Solid preview

Manifest storefront with a solid editorial navigation rail and no routine links

Header settings

SettingValue
Header compositionStudio bar
Desktop navigation layoutNavigation rail
Main menu alignmentCenter for an editorial balance, or Left for a catalog-led layout
Desktop brand signatureA short phrase, or blank to hide it
Header background styleTransparent or Solid; compare the previews above
Surface finishSoft shadow
Header behaviorSmart sticky on scroll
Show routine links on desktopOff

Menu block settings

SettingRecommended value
Desktop menu font sizeSmall or Medium
Show submenu arrowsOn when the menu has nested links
Desktop menu letter caseCapitalize
Desktop submenu layoutColumns for broad groups; Fly-out panel for compact, deeper groups

Keep top-level labels short and distinctive. If the primary menu cannot fit one line, Manifest temporarily shows the compact Menu drawer instead. The saved Navigation rail setting does not change, and the rail returns automatically when enough space becomes available.

Transparent preview

Manifest storefront with a transparent editorial navigation rail and a separate Shop by routine group

Solid preview

Manifest storefront with a solid editorial navigation rail and a separate Shop by routine group

Start with every setting from version A, including Surface finish → Soft shadow, then apply only these additional settings:

LocationSettingValue for the illustrated design
Header sectionMain menu alignmentLeft
Menu blockUtility menu for desktop and mobileA small menu containing Search and About Us
Header sectionShow routine links on desktopOn
Header sectionShow routine links on mobileOff; configure mobile separately if needed
Header sectionRoutine links headingShop by routine
Header sectionMaximum routine links on each device2

Create the utility menu under Content → Menus, then select it in the Header section’s Menu block. Search and About Us reproduce the screenshot, but you can use any two to five useful shortcuts. Do not repeat every primary link or use this group for policy links.

When space allows, the main menu stays on the left and the routine group sits on the right. When they cannot share one row, the routine group moves to its own row. If the primary main menu itself cannot fit one line, Manifest temporarily switches to the complete Menu drawer so every link remains available.

C. Compact Menu bar

Transparent preview

Manifest storefront with a transparent compact one-row Studio Menu bar

Solid preview

Manifest storefront with a solid compact one-row Studio Menu bar

Start with version A, including Surface finish → Soft shadow, and change one setting:

LocationSettingValue
Header sectionDesktop navigation layoutMenu drawer

That single change removes the visible rail and places a labeled Menu button beside the brand in one compact row. Your main, nested, secondary, and enabled routine links remain available inside the complete menu. The Desktop menu opening style setting then controls whether that button opens a Navigation panel or a Side drawer; it does not change the closed appearance shown here.

Choose a solid or transparent background

The background treatment does not create a separate header design. Keep the same version and select Header background style → Solid for an opaque header, or Transparent when a compatible full-bleed Hero banner or Product stage opens the page. For a transparent header, set Transparent header text to Light over dark imagery or Color scheme over pale imagery. Pages without compatible opening media use the solid, readable header automatically. On mobile, a Product stage slide set to Fit within the stage also uses an opaque header in the header’s selected color scheme. A filled slide keeps the configured overlay treatment.

Mobile appearance for A, B, and C

Transparent preview

Mobile Manifest storefront with the transparent Design 1 header

Solid preview

Mobile Manifest storefront with the solid Design 1 header

All three desktop versions use the same compact mobile header when routine links are disabled on mobile. To reproduce the screenshot, set Mobile logo position to Start, Mobile menu opening style to Navigation panel, and Show routine links on mobile to Off. Search, account, cart, and the Menu button remain visible in one row. The desktop rail and its alignment do not carry into the mobile layout.

Transparent preview

Manifest storefront with a transparent Fine outline navigation rail and routine links

Solid preview

Manifest storefront with a solid Fine outline navigation rail and routine links

Start with every setting from version B and change one setting:

LocationSettingValue
Header sectionSurface finishFine outline

This keeps the main menu on the left and the routine group on the right when space allows. The same automatic Menu drawer fallback protects every link when the primary menu cannot fit on one line.

Transparent preview

Manifest storefront with a transparent Fine outline navigation rail and no routine links

Solid preview

Manifest storefront with a solid Fine outline navigation rail and no routine links

Start with every setting from version A and change one setting:

LocationSettingValue
Header sectionSurface finishFine outline

F. Compact Menu bar with Fine outline

Transparent preview

Manifest storefront with a transparent Fine outline compact Menu bar

Solid preview

Manifest storefront with a solid Fine outline compact Menu bar

Start with every setting from version C and change one setting:

LocationSettingValue
Header sectionSurface finishFine outline

Mobile appearance for D, E, and F

Mobile Manifest storefront shared by the Fine outline Studio variants

Versions D, E, and F share this compact mobile arrangement. To reproduce the screenshot, set Mobile logo position to Center, Mobile menu opening style to Navigation panel, and Show routine links on mobile to Off. The Menu button moves to the start of the row, while search, account, and cart remain at the end.

Design 2: Split dock over a hero

Choose this for the most visual composition. Split dock separates the Menu button, brand, and utilities into floating surfaces so the opening image remains visible between them.

Transparent preview

Manifest storefront with a transparent Split dock header and no routine links

Solid preview

Manifest storefront with a solid Split dock header and no routine links

Header settings

SettingValue
Header compositionSplit dock
Desktop navigation layoutNavigation rail
Desktop menu opening styleNavigation panel
Header background styleTransparent or Solid; compare the previews above
Transparent header textWhen the background is Transparent, use Color scheme over pale imagery or Light over dark imagery
Apply soft shadowOn
Header behaviorSmart sticky on scroll
Show routine links on desktopOff

The Menu button and brand share the left dock while country, search, account, and cart occupy the right dock. Desktop navigation layout → Navigation rail also defines the Studio fallback used on pages that do not begin with compatible full-bleed media. Changing Header background style changes only the surface treatment: Transparent allows the hero to show through the dock, while Solid uses the selected color scheme.

Transparent preview

Manifest storefront with a transparent Split dock header and an expanded routine-link group

Solid preview

Manifest storefront with a solid Split dock header and an expanded routine-link group

Start with every setting from version A, then apply these additional settings:

LocationSettingValue for the illustrated design
Menu blockUtility menu for desktop and mobileA small menu containing Search and About Us
Header sectionShow routine links on desktopOn
Header sectionShow routine links on mobileOff
Header sectionRoutine links headingShop by routine
Header sectionMaximum routine links on each device2

With the Navigation rail fallback selected, Split dock places enabled routine links below the brand in the left floating surface. If Desktop navigation layout is changed to Menu drawer, the routine links remain available inside the complete menu instead of appearing in that surface.

Mobile appearance for A and B

Transparent preview

Mobile Manifest storefront with the transparent Split dock header

Solid preview

Mobile Manifest storefront with the solid Split dock header

Both versions use this mobile arrangement when Show routine links on mobile is off. Set Mobile logo position to Center and Mobile menu opening style to Navigation panel. The Menu button remains at the start, the logo is centered, and search, account, and cart remain at the end.

Split dock appears only when the page opens with a compatible full-bleed Hero banner or Product stage. Everywhere else, Manifest uses the corresponding Studio fallback:

  • Navigation rail gives those pages a visible Studio rail.
  • Menu drawer gives those pages a compact, one-row Studio header.

This fallback is intentional. It keeps the header readable when there is no opening image for the floating dock to sit over.

Routine links are short, repeated entry points such as Morning, Evening, Sensitive skin, or Travel. They come from the Utility menu for desktop and mobile selected in the Menu block. Design 1B shows the complete setup for a Studio navigation rail. In the other designs, the same menu is placed as follows:

Where the links appear depends on the chosen design:

DesignRoutine-link placement
Studio with Navigation railIn the rail when space allows; otherwise on its own row
Studio with Menu drawerInside the complete navigation menu
Split dock with Navigation rail fallbackIn the floating routine rail and in the Studio fallback
Split dock with Menu drawer fallbackInside the complete navigation menu

Use this menu for genuinely useful alternate paths, not for policy links or a second copy of every primary destination.

Build nested menus and promotions

The structure is controlled in Content → Menus:

  • Top-level links are primary navigation.
  • Links nested one level below are secondary navigation.
  • Third-level links use the Desktop submenu layout selected in the Menu block when the visible Navigation rail is active.

Columns

Set Menu block → Desktop submenu layout to Columns when shoppers benefit from seeing several groups and their links at once.

Broad nested menu

Manifest Header Columns submenu showing several link groups and a featured promotion

Shallow menu

Manifest Header Columns submenu showing a short link list and a featured promotion

A deeply nested menu uses each secondary link as a column heading and places its third-level links below it. A shallow menu stays compact because there are no third-level groups to expand. Menu promotion blocks appear alongside the links when they are attached to the open top-level item.

Fly-out panel

Set Menu block → Desktop submenu layout to Fly-out panel when the first choice should stay compact and shoppers can open one deeper group at a time.

Nested group open

Manifest Header Fly-out panel submenu with one nested group open beside the parent panel

Shallow menu

Manifest Header Fly-out panel submenu showing a short link list and featured promotion

Secondary links stay in the parent panel. Opening a link that has children reveals its third-level links in the adjacent panel. A shallow menu does not create an empty fly-out; it remains a single compact panel. Promotions remain in the parent panel.

To add visual content to a menu, add a Menu promotion block in the Header section:

  1. Enter the exact top-level link label under Attach to menu item.
  2. Choose a Promotion image and its ratio.
  3. Add meaningful Alt text.
  4. Add the eyebrow, heading, subheading, link, and link label.
  5. Add more promotion blocks with the same top-level label to create a browsable promotion rail.

If a promotion does not appear, compare Attach to menu item with the Shopify menu label, including spaces and punctuation.

Set up mobile navigation

Mobile uses the same main menu but has its own presentation settings.

SettingHow to choose
Mobile logo positionStart keeps the row directional; Center creates a symmetrical brand lockup
Mobile menu opening styleNavigation panel gives the menu an editorial overview; Side drawer uses a familiar vertical hierarchy
Show routine links on mobileTurn on only when those shortcuts are useful on a small screen

Open the phone preview and test at least one menu branch through every nesting level. Also open search, the country and language selector, the account menu, and the cart so the complete header flow is checked rather than only its closed appearance.

Understand the automatic rail fallback

Navigation rail remains the layout you selected. When the primary menu cannot fit on one line, Manifest temporarily switches the Studio header to its compact, one-row Menu drawer. The saved setting is not changed. Every primary, nested, secondary, and enabled routine link remains available in the drawer, and the rail returns when sufficient space becomes available.

Manifest measures again after the browser is resized, web fonts finish loading, the page loads, or the Header section reloads in the theme editor. If keyboard focus is inside the rail when it collapses, focus moves to the visible Menu button.

With JavaScript disabled, navigation wraps instead of clipping. Do not shrink menu text, clip links, or introduce horizontal scrolling to force a long menu into one line. Shorten unclear labels or use the Menu drawer design when a compact header is the intended look.

Add shipping and gift goals to the cart drawer

In Header → Cart drawer, use Cart rewards to show an optional shipping spend goal, a gift spend goal, or both above the cart items. Add the Cart drawer block if it is missing; the Header supports one of these blocks.

SettingDefaultHow to use it
Show free shipping progressOffTurn on after configuring a matching free shipping rate in Shopify shipping settings
Free shipping threshold50Enter the qualifying amount in the store currency, such as 50, 65, or 49.95; appears when shipping progress is on
Show free gift progressOffTurn on after configuring a matching gift offer and fulfillment; works independently of shipping progress
Free gift threshold75Enter the gift spend goal in the store currency; appears when gift progress is on
Gift namea free mini cleanserName the reward as it should appear in “Add $25.00 to unlock a free mini cleanser.”; a blank name falls back to “a free gift”
Gift linkNoneOptionally link to the gift product or offer details; “View your gift” appears after reaching the gift goal
Progress styleCircleChoose Circle, Rounded bar, or Segmented bar; appears when either progress option is on

Circle places a small circular meter around the icon beside the message. Rounded bar uses a slim, 6px pill-shaped track. Segmented bar divides the track into eight sections. Shipping alone uses a delivery icon; enabling a valid gift goal uses a gift icon. All styles use the same totals and goals and respect the global interface animation speed, No motion, and reduced motion.

With shipping alone, a $50 goal and a $38 cart show “You are $12.00 away from free shipping!” at 76%. At $50, the meter is full and the message reads “You’ve unlocked free shipping!”

With a $50 shipping goal and a $75 gift goal, the same $38 cart still names the $12 remaining for shipping, but the meter measures 38/75 toward the final tier. At $50, the shipping row shows “✓ Goal reached”, and the message changes to “Add $25.00 to unlock a free mini cleanser.” At $75, both rows show that their goals are reached, the meter fills completely, and the gift link appears if set. Gift progress also works alone. If the gift threshold is lower than shipping, the message names the gift first and then shipping; equal thresholds reach both goals together. Removing items or applying discounts updates the message, reached labels, link visibility, and meter in both directions.

The Cart drawer block owns the toggles, thresholds, gift copy, gift link, and style. Shopify cart data owns the total after discounts, including paid samples and gift wrapping. Free items do not increase progress. Shopify shipping settings own actual rates. The merchant owns the gift offer and fulfillment. No metafields or apps are required for the display.

This is a progress display. It does not add a gift, change prices, apply a discount, or create a shipping rate. Configure and test the matching offer separately. For a Shopify Buy X get Y offer, customers must add the gift themselves. Use the gift link to make it easy to find. Shopify discount eligibility can use different products or spending rules from this cart-total display. Only enable progress when the offer applies to all products and shoppers in the store currency and matches the displayed total after discounts. Verify discounts, combinations, and checkout eligibility before publishing; a reached display goal does not verify Shopify discount eligibility.

Both goals hide for an empty cart or another presentment currency. Shipping progress also hides when the cart does not require shipping; the gift goal can still display. A blank, zero, or negative threshold disables that goal without affecting the other. The theme editor shows setup notes for invalid thresholds and a currency note when the preview market differs from the store currency. Choose a market using the store currency to preview the goals. Existing saved shipping settings retain their values; gift progress is off by default.

The display updates when the drawer opens and after quantities, removals, samples, and gift wrapping change. Its translated message announces changes to screen readers. Check below, exactly at, and above each threshold, then remove an item to cross back below it. Test the gift link with keyboard navigation and verify the matching offer and shipping rate at checkout.

Finish the shared details

These settings can be applied to every recipe:

  • Color scheme controls the solid header and fallback colors.
  • Header behavior can be Smart sticky on scroll, Always sticky, or Static. Smart sticky is the balanced default because it returns when a shopper scrolls upward.
  • Blur background behind open menus separates navigation, search, and localization surfaces from the page beneath them.
  • The Icons block selects outline or filled icons, hover behavior, search and account visibility, the account menu, and the cart icon.
  • The Country and language block controls how the current country or currency is labeled. Add it only when the corresponding Shopify Markets options are configured.

Before publishing, check the header with the longest translated labels you expect to support. The automatic fallback protects access to every link, but the chosen design should still look deliberate in the languages your store serves.

New Header menu pickers default to Shopify’s Main menu, which exists in a fresh store. Customer account menu keeps Shopify’s native account links while Main menu or an empty value is selected; choose a separate account menu for custom links. Utility menu for desktop and mobile omits a duplicate of the primary navigation; choose a separate menu for useful shortcuts. Existing saved selections remain.

Editor reloads preserve only the theme-owned quick-view selection. Shopify keeps control of section scrolling and focus. Quick view preserves language/market URL prefixes. The Cart rewards settings and saved values remain intact.

Header design

100%

Use the zoom controls, then scroll to inspect the image. Press Escape to close.

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-6
Header compositionDropdown

Studio bar uses a two-level editorial structure. Split dock appears only above a compatible full-bleed opening section; every other page uses the Studio fallback configured below.

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

Desktop layout

Desktop navigation layoutDropdown

Navigation rail shows the main menu below the Studio brand and automatically switches to the Menu drawer when links do not fit one line. It also displays enabled Split dock routine links. Menu drawer keeps Studio to one row and moves Split dock routine links into the full menu. On other pages, Split dock uses the corresponding Studio fallback.

ID
desktop_navigation
Default
Navigation rail
  • Navigation railrail
  • Menu drawerdrawer
Desktop menu opening styleDropdown

Choose how the full menu opens from the header.

ID
desktop_menu_presentation
Default
Navigation panel
Shown when
header_composition is 'split-dock' or desktop_navigation is 'drawer'
  • Navigation panelpanel
  • Side drawerside
Apply glass finishCheckbox

Makes the open menu panel slightly transparent so the page shows through behind it.

ID
menu_drawer_glass
Default
On
Shown when
header_composition is 'split-dock' or desktop_navigation is 'drawer'
Main menu alignmentDropdown

Choose whether the main menu starts at the left or sits in the center of the navigation rail.

ID
rail_menu_alignment
Default
Center
Shown when
desktop_navigation is 'rail'
  • Leftleft
  • Centercenter
Desktop brand signatureText

Use a short phrase beside the desktop logo. Longer text ends with an ellipsis. Leave blank to hide it.

ID
signature_text
Default
CARE, SEQUENCED.

Mobile layout

Mobile logo positionDropdown

Choose whether the logo starts the mobile header row or sits in the center.

ID
mobile_brand_position
Default
Center
  • Startstart
  • Centercenter
Mobile menu opening styleDropdown

Choose how the full menu opens from the header.

ID
mobile_menu_presentation
Default
Navigation panel
  • Navigation panelpanel
  • Side drawerside

Routine links

Show routine links on desktopCheckbox

Choose the Utility menu in the Menu block to populate these links. With Split dock, Navigation rail shows them below the brand while Menu drawer keeps them inside the full menu.

ID
show_routine_links
Default
Off
Show routine links on mobileCheckbox

Uses the same Utility menu and maximum link count as the desktop routine links.

ID
show_mobile_routine_links
Default
Off
Routine links headingText

Applies on each device that shows routine links.

ID
routine_label
Default
Shop by routine
Shown when
show_routine_links or show_mobile_routine_links
Maximum routine links on each deviceSlider

Sets one shared limit for desktop and mobile.

ID
routine_link_limit
Default
4
Range
2 to 5, in steps of 1
Shown when
show_routine_links or show_mobile_routine_links

Behavior and appearance

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
Transparent
  • Solidsolid
  • Transparenttransparent
Transparent header textDropdown

Light suits dark imagery. Color scheme suits pale imagery.

ID
overlay_text_color
Default
Color scheme
Shown when
header_composition is 'split-dock' or header_background_style is 'transparent' or surface_finish is 'soft'
  • Lightlight
  • Color schemescheme
Surface finishDropdown

Controls Studio surfaces on desktop and mobile. 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
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'
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 you leave the logo empty.

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

Appearance

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 and zoomfade-scale

Controls

Search iconDropdown
ID
search_icon
Default
Magnifier
  • Magnifiermagnifier
  • Hiddennone
Account iconDropdown
ID
account_icon
Default
Person
  • Personperson
  • Person in circleperson_circle
  • Hiddennone
Customer account menuMenu

Choose a separate customer account menu. The default main menu or an empty selection keeps Shopify's account links.

ID
customer_account_menu
Default
main-menu
Shown when
account_icon is not 'none'
Cart iconDropdown
ID
cart_icon
Default
Basket
  • Bagbag_icon
  • Carttrolley_icon
  • Basketbasket_icon

Menu menu_block max 1

MenuMenu
ID
menu
Default
main-menu
Utility menu for desktop and mobileMenu

Choose a separate menu for navigation utilities and routine links. The default main menu does not repeat primary navigation.

ID
utility_menu
Default
main-menu
Shown when
desktop_menu_presentation is 'panel' or mobile_menu_presentation is 'panel' or show_routine_links or show_mobile_routine_links
Navigation panel headingText
ID
panel_heading
Default
MENU
Shown when
desktop_menu_presentation is 'panel' or mobile_menu_presentation is 'panel'
Desktop panel columnsDropdown

Sets link group columns in the desktop navigation panel. Smaller desktop screens adapt automatically.

ID
panel_link_columns
Default
Three
Shown when
desktop_menu_presentation is 'panel'
  • Two2
  • Three3
  • Four4
Show account link in navigation panelsCheckbox

Applies to desktop and mobile panels. Turn on customer accounts to show the link.

ID
show_account_in_panel
Default
On
Shown when
desktop_menu_presentation is 'panel' or mobile_menu_presentation is 'panel'
Desktop menu font sizeDropdown
ID
menu_font_size
Default
Small
Shown when
desktop_navigation is 'rail'
  • Smalldesktop_menu_small
  • Mediumdesktop_menu_medium
  • Largedesktop_menu_large
Show submenu arrowsCheckbox

Shows an arrow beside desktop navigation links that contain a submenu.

ID
show_submenu_arrows
Default
On
Shown when
desktop_navigation is 'rail'
Desktop menu letter caseDropdown
ID
menu_text_transform
Default
Capitalize
Shown when
desktop_navigation is 'rail'
  • Uppercaseuppercase
  • Capitalizecapitalize
  • Lowercaselowercase
Desktop submenu layoutDropdown

Choose how third-level links appear in the desktop navigation rail when a menu group has nested items.

ID
submenu_style
Default
Columns
Shown when
desktop_navigation is 'rail'
  • Columnscolumns
  • Fly-out panelflyout

Country and language currency_selector max 1

Font styleDropdown
ID
font_style
Default
Regular
  • Regularregular
  • Boldbold
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

Cart drawer cart_drawer max 1

Cart rewards

Show free shipping progressCheckbox

Match a free shipping rate in Shopify shipping settings; this display does not create rates. Enter the goal in your store currency, such as 50 or 65. Uses the total after discounts. Hidden in other currencies and carts without shipping. Use only when the goal applies to all shipping destinations and product shipping profiles in this currency.

ID
show_free_shipping
Default
Off
Free shipping thresholdNumber
ID
free_shipping_threshold
Default
50
Shown when
show_free_shipping
Show free gift progressCheckbox

Display a gift spend goal in your store currency using the total after discounts. This does not add or discount a gift. Configure a matching offer and fulfillment separately. Use only for offers applying to all products and shoppers in this currency. Hidden in other currencies.

ID
show_free_gift
Default
Off
Free gift thresholdNumber
ID
free_gift_threshold
Default
75
Shown when
show_free_gift
Gift nameText
ID
free_gift_name
Default
a free mini cleanser
Shown when
show_free_gift
Gift linkLink

Optional. Link to the gift product or offer details. Appears once the customer reaches the goal. Customers must add the gift themselves for Shopify Buy X get Y offers; verify the discount rules match this displayed goal.

ID
free_gift_link
Shown when
show_free_gift
Progress styleDropdown
ID
free_shipping_style
Default
Circle
Shown when
show_free_shipping or show_free_gift
  • Circlecircle
  • Rounded barrounded
  • Segmented barsegmented

Samples

Show samplesCheckbox
ID
show_samples
Default
Off
Sample headingText
ID
sample_heading
Default
Add a sample
Shown when
show_samples
Sample body textText
ID
sample_description
Default
Try a travel size alongside your order.
Shown when
show_samples
Sample productsproduct_list

Choose single-variant sample products. The first available variant supplies each sample.

ID
sample_products
Limit
6
Sample collectionCollection

Applies when you leave the sample products empty. The collection supplies its own product order.

ID
sample_collection
Samples to showSlider
ID
samples_to_show
Default
3
Range
2 to 6, in steps of 1
Shown when
show_samples
Sample limitSlider

The most samples a customer can keep in the cart at one time.

ID
max_samples
Default
2
Range
1 to 5, in steps of 1
Shown when
show_samples

Samples are regular products at the price set on each product, and inventory applies. A sample shows as free only when its price is 0.

Gift options

Gift wrap productProduct

Leave this empty to offer a gift message only. Choose an active product. The first available variant supplies the gift, and product data provides the title, image, price, and availability.

ID
gift_wrap_product
Show gift messageCheckbox
ID
show_gift_message
Default
On
Gift headingText
ID
gift_heading
Default
Make it a gift
Shown when
show_gift_message or gift_wrap_product is set
Gift body textText
ID
gift_description
Default
Add a thoughtful finishing touch before checkout.
Shown when
show_gift_message or gift_wrap_product is set
Gift message labelText
ID
gift_message_label
Default
Add a gift message
Shown when
show_gift_message
Gift message placeholderText
ID
gift_message_placeholder
Default
Write a personal note for the recipient.
Shown when
show_gift_message

Order details

Show order noteCheckbox
ID
show_order_note
Default
On

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
Shown when
submenu_image is set
Image ratioDropdown
ID
image_ratio
Default
Portrait
Shown when
submenu_image is set
  • Portraitportrait
  • Squaresquare
  • Landscapelandscape
EyebrowText
ID
eyebrow
Default
Featured promotion
HeadingRich text (inline)
ID
heading
Default
The ritual edit
SubheadingRich text (inline)
ID
subheading
Default
A considered selection of products for a complete daily routine.
Link labelText
ID
link_label
Default
Shop the edit
Shown when
submenu_image_link is set