> For the complete documentation index, see [llms.txt](https://docs.strm.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.strm.design/reference/sections/header.md).

# Header

The header on every page: logo, main menu with mega menu panels, utility links, search, account and bag, in six layouts.

The header on every page: logo, main menu with mega menu panels, utility links, search, account and bag, in six layouts.

**Where:** Header group (top of every page)\
**File:** `sections/header.liquid`

![Header](https://2073252647-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUX7okZwFVjG38blUMwqg%2Fuploads%2Fgit-blob-3e6e07925189293316a408fff1e56589b758a293%2Fheader.png?alt=media)

## Section settings

| Setting                           | Type         | Options | Default  | Notes |
| --------------------------------- | ------------ | ------- | -------- | ----- |
| **Color scheme**                  | Color scheme |         | Scheme 1 |       |
| **Keep header visible on scroll** | On / off     |         | On       |       |

### Layout

| Setting                                           | Type     | Options                                                                                                                                                                                                  | Default                              | Notes                                                                                                                          |
| ------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| **Layout**                                        | Choice   | Classic: logo and search, menu below, Global bar: one slim row, Centered: logo in the middle, menu below, Floating pill, Search first: wide search, menu as chips, Split: menu on both sides of the logo | Classic: logo and search, menu below |                                                                                                                                |
| **Menu links left of the logo**                   | Slider   | 1–6, steps of 1                                                                                                                                                                                          | 3                                    | The other main menu links sit right of the logo. Shown when **Layout** is Split: menu on both sides of the logo.               |
| **Show "All" chip**                               | On / off |                                                                                                                                                                                                          | On                                   | Links to all products, before the menu chips. Shown when **Layout** is Search first: wide search, menu as chips.               |
| **Float over the first section on the home page** | On / off |                                                                                                                                                                                                          | On                                   | Use with a full-width image or video first. The pill turns solid when shoppers scroll. Shown when **Layout** is Floating pill. |

### Icons and labels

| Setting     | Type   | Options                                       | Default          | Notes                                |
| ----------- | ------ | --------------------------------------------- | ---------------- | ------------------------------------ |
| **Account** | Choice | Icon in a circle, Icon, Text                  | Icon in a circle | Shows when customer accounts are on. |
| **Bag**     | Choice | Filled pill, Icon with count, Text with count | Filled pill      |                                      |

### Navigation

| Setting                                 | Type                       | Options | Default   | Notes                                                                                                                   |
| --------------------------------------- | -------------------------- | ------- | --------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Main menu**                           | Menu                       |         | main-menu | Second-level links open in a large panel on desktop. Third-level links show as grouped lists.                           |
| **Note beside the main menu**           | Text (bold, italic, links) |         |           | For example, a short delivery promise. Keep it accurate. Shown when **Layout** is Classic: logo and search, menu below. |
| **Show country and language selectors** | On / off                   |         | Off       | Selectors appear only when your store sells in more than one country or language.                                       |

### Search

| Setting                          | Type       | Options                           | Default      | Notes                                                                                                                                                                        |
| -------------------------------- | ---------- | --------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Show search**                  | On / off   |                                   | On           |                                                                                                                                                                              |
| **Search**                       | Choice     | Search field, Icon, Icon and text | Search field | Icon and text open the search field below the header. Search first always shows the field; Floating pill uses the icon instead of a field. Shown when **Show search** is on. |
| **Search field text**            | Text       |                                   |              |                                                                                                                                                                              |
| **Popular searches**             | Text       |                                   |              | Separate terms with commas. Shown before shoppers type.                                                                                                                      |
| **Trending products collection** | Collection |                                   |              |                                                                                                                                                                              |

### Product bar

| Setting                               | Type                 | Options | Default | Notes                                                                                                                                  |
| ------------------------------------- | -------------------- | ------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Show product bar on product pages** | On / off             |         | Off     | Product title, price and a Buy button that jumps to the add to bag form. Not shown with Floating pill.                                 |
| **Product bar links**                 | Text (several lines) |         |         | Optional. One link per line as Label \| link, for example Reviews \| #reviews. Shown when **Show product bar on product pages** is on. |

## Built-in blocks

These blocks are always part of the section: select them in the section’s block list to edit them. They cannot be removed or added again.

### Menu panel products block

Adds product cards from a collection to the mega menu panel of a main menu item.

| Setting              | Type       | Options         | Default | Notes                                                                                                                                             |
| -------------------- | ---------- | --------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Main menu item**   | Text       |                 |         | The main menu item name, for example Cookware (capital letters don't matter). The item opens a panel with these products, even without a submenu. |
| **Collection**       | Collection |                 |         |                                                                                                                                                   |
| **Products to show** | Choice     | One, Two, Three | Two     |                                                                                                                                                   |

## Blocks

### Header menu block

Utility links from a menu, shown beside the bag.

| Setting                                | Type     | Options | Default   | Notes                                                                                                                               |
| -------------------------------------- | -------- | ------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Menu**                               | Menu     |         | main-menu | Choose a menu with your utility links, for example Trade and Compare. Top-level links show beside the bag; sub-links are not shown. |
| **Show number of products in compare** | On / off |         | On        | Applies to links to a page that uses the compare template.                                                                          |

### Header link block

A single utility link beside the bag, optionally with the number of products in compare.

| Setting                                | Type     | Options | Default | Notes                                |
| -------------------------------------- | -------- | ------- | ------- | ------------------------------------ |
| **Label**                              | Text     |         | Link    |                                      |
| **Link**                               | Link     |         |         |                                      |
| **Show number of products in compare** | On / off |         | Off     | Use for a link to your compare page. |

## Presets

Add it from **Add section** as: **Header**, **Header: global bar**, **Header: centered**, **Header: floating pill**, **Header: search first**, **Header: split**.
