> For the complete documentation index, see [llms.txt](https://ursus-ecom.gitbook.io/arctos-theme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ursus-ecom.gitbook.io/arctos-theme/theme-settings/page-header.md).

# Page header

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

{% hint style="info" %}
**Where to find it:** In the theme editor (**Customize**), go to **Theme settings > Page header.**
{% endhint %}

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.

<figure><img src="https://1411897219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP6Y96SO1y456EU9GTaCh%2Fuploads%2Fgit-blob-83f9bab764ca32f09b3405c352e21aaac49d4bfa%2Fpage-header-overview.webp?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1411897219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP6Y96SO1y456EU9GTaCh%2Fuploads%2Fgit-blob-bc1e1c220ab49b273c0ae136d6bc0bf41aa5ef0d%2Fpage-header-layers.webp?alt=media" alt=""><figcaption></figcaption></figure>

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](#id-2.-page-header-layout)
* **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](#id-3.-header-content)
* **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.

<table><thead><tr><th width="300.40234375">Page</th><th>Supporting elements</th></tr></thead><tbody><tr><td>Collection</td><td>Quick filter</td></tr><tr><td>Blog</td><td>Tags</td></tr><tr><td>Blog post</td><td>Post details</td></tr><tr><td>Search results</td><td>Quick filter</td></tr><tr><td>Cart</td><td>None</td></tr><tr><td>Standard pages (FAQs, Policy, etc.)</td><td>None</td></tr></tbody></table>

#### 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](#id-3.-content-style)
* **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.

{% hint style="info" %}
The page header follows the same layout logic as the Group element. Read the [Group](https://ursus-ecom.gitbook.io/arctos-theme/blocks/layout/group.md) documentation to understand how the frame and content block interact before adjusting these settings.
{% endhint %}

{% hint style="info" %}
**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.
{% endhint %}

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

<figure><img src="https://1411897219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP6Y96SO1y456EU9GTaCh%2Fuploads%2Fgit-blob-fa7a35e944f2fae044218c9fec01735f41656d95%2Fpage-header-layout.webp?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="110.3046875">Setting</th><th width="134.26953125">Options</th><th width="480.546875">What it does</th></tr></thead><tbody><tr><td><strong>Container width</strong></td><td><ul><li>Full width</li><li>Standard</li><li>Wide</li></ul></td><td><p>Sets how far the page header stretches across the screen.</p><ul><li><strong>Full width</strong> spans edge to edge for a bold, immersive look.</li><li><strong>Standard</strong> and <strong>Wide</strong> constrain it to your theme's container width defined in <a href="https://ursus-ecom.gitbook.io/arctos-theme/theme-settings/section.md">Section</a> settings, keeping it aligned with the rest of the page.</li></ul></td></tr><tr><td><strong>Height</strong></td><td><ul><li>Auto</li><li>Small</li><li>Medium</li><li>Large</li><li>Full</li></ul></td><td><p>Controls the overall height of the header area.</p><ul><li><strong>Auto</strong> shrinks or grows to fit the content inside.</li><li><strong>Small</strong> to <strong>Large</strong> give you increasing amounts of whitespace above and below the content, adding visual weight and presence to the page top.</li><li><strong>Full</strong> stretches the header to cover the entire viewport, useful for editorial or landing-style pages.</li></ul></td></tr><tr><td><strong>Alignment</strong></td><td><ul><li>Left</li><li>Center</li><li>Right</li></ul></td><td><p>Sets where the header content block sits horizontally inside the frame.</p><ul><li><strong>Left</strong> is the default for most stores.</li><li><strong>Center</strong> works well for minimal or brand-forward layouts.</li></ul><p><em>Only takes effect when <strong>Header content width</strong> is set to anything other than <strong>Fill</strong>.</em></p></td></tr><tr><td><strong>Position</strong></td><td><ul><li>Top</li><li>Middle</li><li>Bottom</li><li>Space between</li></ul></td><td><p>Sets where the header content block sits vertically inside the frame.</p><ul><li><strong>Middle</strong> is the most common choice when using a fixed height.</li><li><strong>Space between</strong> pushes the content block and supporting elements to opposite ends of the frame.</li></ul><p><em>Only takes effect when <strong>Height</strong> is set to anything other than <strong>Auto</strong>.</em></p></td></tr><tr><td><strong>Gap</strong></td><td><ul><li>Default</li><li>4–32px</li><li>Custom</li></ul></td><td><p>Controls the spacing between the header content block and any supporting elements like a breadcrumb or filter bar.</p><p>Increasing the gap creates clearer visual separation between them; reducing it groups them more tightly.</p></td></tr><tr><td><strong>Custom on mobile</strong></td><td><ul><li>On</li><li>Off</li></ul></td><td>Sets separate alignment and gap values for mobile.</td></tr></tbody></table>

{% hint style="info" %}
For a deeper look at how alignment, position, and gap interact, see the [Group](https://ursus-ecom.gitbook.io/arctos-theme/blocks/layout/group.md) documentation.
{% endhint %}

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

<figure><img src="https://1411897219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP6Y96SO1y456EU9GTaCh%2Fuploads%2Fgit-blob-1be9582a273bc7e055774957d504707015e899e9%2Fpage-header-header-content.webp?alt=media" alt=""><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th width="109.75390625">Setting</th><th width="134.18359375">Options</th><th width="481.52734375">What it does</th></tr></thead><tbody><tr><td><strong>Width</strong></td><td><ul><li>Fit</li><li>Fill</li><li>Custom</li></ul></td><td><p>Controls how wide the content block is inside the container.</p><ul><li><strong>Fit</strong> wraps tightly around the title and description, keeping the block compact.</li><li><strong>Fill</strong> stretches it to the full container width, which affects how alignment behaves.</li><li><strong>Custom</strong> lets you set a precise width in pixels or percentage.</li></ul></td></tr><tr><td><strong>Direction</strong></td><td><ul><li>Vertical</li><li>Horizontal</li></ul></td><td><p>Sets whether the title and description stack on top of each other (Vertical) or sit side by side (Horizontal).</p><p><em><strong>Horizontal</strong> is useful for collection or blog pages where you want the title on one side and a short description on the other.</em></p></td></tr><tr><td><strong>Content alignment</strong></td><td><ul><li>Left</li><li>Center</li><li>Right</li></ul></td><td>Sets how the breadcrumb, title and description align together as a unit inside the content block. This affects all elements at once, not individually.</td></tr><tr><td><strong>Content position</strong></td><td><ul><li>Top</li><li>Middle</li><li>Bottom</li></ul></td><td>Sets how the content is positioned vertically when Direction is Horizontal.</td></tr><tr><td><strong>Align baseline</strong></td><td><ul><li>On</li><li>Off</li></ul></td><td>Aligns text to the bottom baseline. Only available when Direction is Horizontal and Content position is Bottom.</td></tr><tr><td><strong>Content gap</strong></td><td><ul><li>Default</li><li>4–32px</li><li>Custom</li></ul></td><td><p>Controls the space between the title and description.</p><p>A smaller gap keeps them visually connected; a larger gap gives the description more breathing room and makes it feel like a secondary element.</p></td></tr><tr><td><strong>Custom on mobile</strong></td><td><ul><li>On</li><li>Off</li></ul></td><td>Sets separate alignment and gap values for mobile.</td></tr></tbody></table>

{% hint style="info" %}
For a deeper look at how alignment, position, and gap interact, see the [Group](https://ursus-ecom.gitbook.io/arctos-theme/blocks/layout/group.md) documentation.
{% endhint %}

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

<figure><img src="https://1411897219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP6Y96SO1y456EU9GTaCh%2Fuploads%2Fgit-blob-90b65486eba84d815e1384d6dee1fc0fe1187518%2Fpage-header-content-style.webp?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="115.0703125">Setting</th><th width="134.140625">Options</th><th width="476.6875">What it does</th></tr></thead><tbody><tr><td><strong>Heading text style</strong></td><td><ul><li>Display</li><li>H1–H6</li><li>Custom</li></ul></td><td>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 <a href="https://ursus-ecom.gitbook.io/arctos-theme/theme-settings/typography.md">typography</a> settings.</td></tr><tr><td><strong>Description text style</strong></td><td><ul><li>Default</li><li>Paragraph</li><li>Custom</li></ul></td><td>Sets the text style for description text below the title. Default uses the theme's built-in description style.</td></tr><tr><td><strong>Custom on mobile</strong></td><td><ul><li>On</li><li>Off</li></ul></td><td>Sets separate text styles for mobile.</td></tr></tbody></table>

{% hint style="info" %}
To change how a text style looks (font, size, weight, and so on), go to [Typography](https://ursus-ecom.gitbook.io/arctos-theme/theme-settings/typography.md) settings.
{% endhint %}

### 5. Spacing

These settings control the padding around the page header content.

<table><thead><tr><th width="149.0703125">Setting</th><th width="113.328125">Options</th><th width="471.23828125">What it does</th></tr></thead><tbody><tr><td><strong>Padding</strong></td><td><ul><li>On</li><li>Off</li></ul></td><td>When on, applies default padding inside the header container.</td></tr><tr><td><strong>Custom on mobile</strong></td><td><ul><li>On</li><li>Off</li></ul></td><td>Sets separate padding values for mobile screens.</td></tr></tbody></table>
