For the complete documentation index, see llms.txt. This page is also available as Markdown.

Page header

These settings control the default appearance of the page header section across your interior pages.

Where to find it: In the theme editor (Customize), go to Theme settings > Page header.

The page header is the area at the top of every interior page on your store, right below the navigation menu and above the page content. Think of it as the first thing a customer sees when they land on a page like your collection, blog, or search results.

Its job is to immediately tell customers where they are, give the page a clear title, and surface any useful tools like breadcrumbs or filters. It also adds visual structure and breathing room to the top of the layout, making pages feel more polished and intentional.

1. Structure

To customize the page header effectively, it helps to understand how it's put together. It has three layers. Think of them like nested boxes, one inside the other.

The structure of page header is as follows:

1.1. Level 1: Page header container

  • What is it: The outermost visual frame or wrapper that holds all header components.

  • Function: Settings at this top level control the overall style of the entire header container. It acts as the parent container, determining how the Header content group and Supporting elements (Level 2) are positioned and aligned inside it.

1.2. Level 2: Header content group and Supporting elements

1.2.1. Header content group

  • What is it: The main core content block nested inside the header, designed to anchor primary navigational and contextual information.

  • Function: This middle layer defines the look of the inner content block itself. It manages the inner layout, determining how the individual Header content elements (Level 3) are arranged, spaced, and positioned within this block.

1.2.2. Supporting elements

  • What is it: Secondary, contextual blocks that change dynamically depending on the specific page layout you are viewing.

  • Controlled by: Settings configured on the specific page to which they belong.

Page
Supporting elements

Collection

Quick filter

Blog

Tags

Blog post

Post details

Search results

Quick filter

Cart

None

Standard pages (FAQs, Policy, etc.)

None

1.3. Level 3: Header content elements

  • What is it: The individual typography, text, and link components that populate the core content block.

  • Controlled by: Content style settings

  • Function: These are the final individual elements (such as breadcrumbs, page headings, or descriptions) that sit inside the Level 2 container. Settings at this level directly control the individual style of these elements.

The page header follows the same layout logic as the Group element. Read the Group documentation to understand how the frame and content block interact before adjusting these settings.

Theme settings > Page header settings apply to all page headers across your store by default. If you need a different look for a specific page, you can override them individually from that page's settings.

2. Page header layout

These layout settings control the structural footprint of the page header. Use them to define the overall width and height of the page header, as well as the alignment and spacing of the content blocks sitting inside it.

Setting
Options
What it does

Container width

  • Full width

  • Standard

  • Wide

Sets how far the page header stretches across the screen.

  • Full width spans edge to edge for a bold, immersive look.

  • Standard and Wide constrain it to your theme's container width defined in Section settings, keeping it aligned with the rest of the page.

Height

  • Auto

  • Small

  • Medium

  • Large

  • Full

Controls the overall height of the header area.

  • Auto shrinks or grows to fit the content inside.

  • Small to Large give you increasing amounts of whitespace above and below the content, adding visual weight and presence to the page top.

  • Full stretches the header to cover the entire viewport, useful for editorial or landing-style pages.

Alignment

  • Left

  • Center

  • Right

Sets where the header content block sits horizontally inside the frame.

  • Left is the default for most stores.

  • Center works well for minimal or brand-forward layouts.

Only takes effect when Header content width is set to anything other than Fill.

Position

  • Top

  • Middle

  • Bottom

  • Space between

Sets where the header content block sits vertically inside the frame.

  • Middle is the most common choice when using a fixed height.

  • Space between pushes the content block and supporting elements to opposite ends of the frame.

Only takes effect when Height is set to anything other than Auto.

Gap

  • Default

  • 4–32px

  • Custom

Controls the spacing between the header content block and any supporting elements like a breadcrumb or filter bar.

Increasing the gap creates clearer visual separation between them; reducing it groups them more tightly.

Custom on mobile

  • On

  • Off

Sets separate alignment and gap values for mobile.

For a deeper look at how alignment, position, and gap interact, see the Group documentation.

3. Header content

The main core content block nested inside the header, designed to anchor primary navigational and contextual information. This settings layer defines the look of the inner content block itself. It manages the inner layout, determining how the individual Header content elements (Level 3) are arranged, spaced, and positioned within this block.

Setting
Options
What it does

Width

  • Fit

  • Fill

  • Custom

Controls how wide the content block is inside the container.

  • Fit wraps tightly around the title and description, keeping the block compact.

  • Fill stretches it to the full container width, which affects how alignment behaves.

  • Custom lets you set a precise width in pixels or percentage.

Direction

  • Vertical

  • Horizontal

Sets whether the title and description stack on top of each other (Vertical) or sit side by side (Horizontal).

Horizontal is useful for collection or blog pages where you want the title on one side and a short description on the other.

Content alignment

  • Left

  • Center

  • Right

Sets how the breadcrumb, title and description align together as a unit inside the content block. This affects all elements at once, not individually.

Content position

  • Top

  • Middle

  • Bottom

Sets how the content is positioned vertically when Direction is Horizontal.

Align baseline

  • On

  • Off

Aligns text to the bottom baseline. Only available when Direction is Horizontal and Content position is Bottom.

Content gap

  • Default

  • 4–32px

  • Custom

Controls the space between the title and description.

A smaller gap keeps them visually connected; a larger gap gives the description more breathing room and makes it feel like a secondary element.

Custom on mobile

  • On

  • Off

Sets separate alignment and gap values for mobile.

For a deeper look at how alignment, position, and gap interact, see the Group documentation.

4. Content style

Content style settings control the typography of the page title and description text inside the Header content group. Use these styling adjustments to establish a clear visual hierarchy between your main page headings and the supporting contextual text.

Setting
Options
What it does

Heading text style

  • Display

  • H1–H6

  • Custom

Sets the text style for the page title. Each option applies a predefined combination of font, size, weight, and letter spacing from your theme's typography settings.

Description text style

  • Default

  • Paragraph

  • Custom

Sets the text style for description text below the title. Default uses the theme's built-in description style.

Custom on mobile

  • On

  • Off

Sets separate text styles for mobile.

To change how a text style looks (font, size, weight, and so on), go to Typography settings.

5. Spacing

These settings control the padding around the page header content.

Setting
Options
What it does

Padding

  • On

  • Off

When on, applies default padding inside the header container.

Custom on mobile

  • On

  • Off

Sets separate padding values for mobile screens.

Last updated