Page header
These settings control the default appearance of the page header section across your interior pages.
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.
Controlled by: Page header layout settings
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.
Controlled by: Page header content settings
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.
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.
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.

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.
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.

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.
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.

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.
5. Spacing
These settings control the padding around the page header content.
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