> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digifist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Page Banner

> Create customizable hero banners for pages, collections, products, and blogs with media, text, and navigation.

The Page Banner section creates versatile hero banners that automatically adapt to different template types (pages, collections, products, blogs). It displays titles, descriptions, media backgrounds, breadcrumbs, and optional collection navigation menus.

This section is essential for creating impactful page headers that provide context and visual appeal across your entire site.

<img src="https://mintcdn.com/digifist/AtUU8Pca9KlehQJT/images/theme/release/sections/page-banner/page-banner-overview.png?fit=max&auto=format&n=AtUU8Pca9KlehQJT&q=85&s=06fc08f3d98c49fe2314090bb4fe1b37" alt="Page banner section overview" width="3280" height="2186" data-path="images/theme/release/sections/page-banner/page-banner-overview.png" />

## What this section controls

This section controls page hero banners with the following capabilities:

* Automatic page title display with custom overrides
* Optional default or custom descriptions
* Desktop and mobile-specific media (images, videos)
* Transparent header support
* Breadcrumb navigation
* Collection menu navigation
* Flexible content positioning and sizing
* Multiple section height options

## How the Page Banner section works

The Page Banner adapts to your template type:

* Automatically displays page/collection/product/blog title
* Shows default description or custom text
* Supports background, top, or bottom media positioning
* Can enable transparent header over background media
* Displays breadcrumbs when enabled in theme settings
* Shows collection navigation menu if configured

## Getting started

<Steps>
  <Step title="Open Theme Customizer">
    From Shopify admin, access the Theme Customizer.
  </Step>

  <Step title="Navigate to target template">
    Go to the page, collection, product, or blog template you want to customize.
  </Step>

  <Step title="Add Page Banner section">
    Add the section or customize the existing one (usually first section).
  </Step>

  <Step title="Configure content and media">
    Set heading, description, media, and positioning options.
  </Step>
</Steps>

<img src="https://mintcdn.com/digifist/AtUU8Pca9KlehQJT/images/theme/release/sections/page-banner/page-banner-location.png?fit=max&auto=format&n=AtUU8Pca9KlehQJT&q=85&s=79c4a263b90419cdcc241ffa4d991d15" alt="Page banner in Theme Customizer" width="3280" height="2186" data-path="images/theme/release/sections/page-banner/page-banner-location.png" />

## Section settings

<Tabs>
  <Tab title="Content">
    ### Enable transparent header

    Makes header transparent over banner when using background media.

    **Default:** True

    <Warning>
      Only works when media position is set to "Background". Header becomes transparent and overlays the banner.
    </Warning>

    ### Heading

    Custom heading text that overwrites the default page title.

    * Inline rich text supported
    * Leave empty to use default page title

    ### Heading size

    Controls the size of heading text.

    **Available options:** XS, S, M, L, XL

    **Default:** L

    ### Description

    Custom description text.

    * Rich text supported
    * Overwrites default description when set

    ### Show default description

    Displays the default description from the current template (page/collection/product/blog).

    **Default:** True

    ### Show on description

    Controls where description is visible.

    **Available options:**

    * **Desktop:** Desktop only
    * **Mobile:** Mobile only
    * **Both:** All devices

    **Default:** Desktop

    <img src="https://mintcdn.com/digifist/JAX1ZL2jzyduQMK4/images/theme/release/sections/page-banner/content-settings.png?fit=max&auto=format&n=JAX1ZL2jzyduQMK4&q=85&s=c68dd295e638360c25fe8ac02635b688" alt="Content settings" width="3280" height="2186" data-path="images/theme/release/sections/page-banner/content-settings.png" />
  </Tab>

  <Tab title="Layout">
    ### Content position

    Controls vertical position of content within the banner.

    **Available options:** Start, Center, End

    **Default:** Center

    <Note>
      Not applicable when section height is set to 'Auto'.
    </Note>

    ### Content alignment

    Controls horizontal alignment of content.

    **Available options:** Start, Center, End

    **Default:** Center

    ### Media position

    Controls where media appears relative to content.

    **Available options:**

    * **Top:** Media above content
    * **Bottom:** Media below content
    * **Background:** Media as background

    **Default:** Background

    <Tip>
      Use 'Background' position with fixed section heights (not 'Auto') for best display. Otherwise, section height expands to cover media.
    </Tip>

    <img src="https://mintcdn.com/digifist/JAX1ZL2jzyduQMK4/images/theme/release/sections/page-banner/layout-settings.png?fit=max&auto=format&n=JAX1ZL2jzyduQMK4&q=85&s=d1804d8b65c14fac5c6bd625fcded7f4" alt="Layout settings" width="3280" height="2186" data-path="images/theme/release/sections/page-banner/layout-settings.png" />
  </Tab>

  <Tab title="Navigation">
    ### Menu

    Link list for collection navigation menu.

    * Shopify link list selector
    * First level link names must match collection handles

    <Note>
      Add a collection menu by creating navigation whose first level link names match any of your shop's collections.
    </Note>

    ### Enable breadcrumbs

    Shows breadcrumb navigation on the page.

    **Default:** True

    <Tip>
      Breadcrumbs must also be enabled in theme settings to appear.
    </Tip>

    <img src="https://mintcdn.com/digifist/JAX1ZL2jzyduQMK4/images/theme/release/sections/page-banner/navigation-settings.png?fit=max&auto=format&n=JAX1ZL2jzyduQMK4&q=85&s=9fb7bd1c6eda41e93678e81449e1eb16" alt="Navigation settings" width="3280" height="2186" data-path="images/theme/release/sections/page-banner/navigation-settings.png" />
  </Tab>

  <Tab title="Desktop">
    ### Section height

    Height of the section on desktop devices.

    **Available options:**

    * **Auto:** Based on content
    * **Third:** 33% viewport height (33svh)
    * **Half:** 50% viewport height (50svh)
    * **Full:** 100% viewport height (100svh)

    **Default:** Half (50svh)

    ### Content width

    Maximum width of content area.

    **Available options:**

    * **Narrow:** 44.5rem
    * **Half:** 50%
    * **Full:** 100%

    **Default:** Full (100%)

    ### Desktop media

    **Image** - Shopify image picker

    **Video** - Video file upload (overwrites image)

    **External video** - YouTube/Vimeo URL

    * Recommended aspect ratio: 16:9
    * Overwrites image and video
    * May cause performance issues

    **Show controls on video** - Enable/disable video controls (default: false)

    <img src="https://mintcdn.com/digifist/JAX1ZL2jzyduQMK4/images/theme/release/sections/page-banner/desktop-settings.png?fit=max&auto=format&n=JAX1ZL2jzyduQMK4&q=85&s=bc06928345c6a1c41163428412f20316" alt="Desktop settings" width="3280" height="2186" data-path="images/theme/release/sections/page-banner/desktop-settings.png" />
  </Tab>

  <Tab title="Mobile">
    ### Section height mobile

    Height of the section on mobile devices.

    **Available options:**

    * **Auto:** Based on content
    * **Third:** 33% viewport height (33svh)
    * **Half:** 50% viewport height (50svh)
    * **Full:** 100% viewport height (100svh)

    **Default:** Half (50svh)

    ### Mobile media

    **Image mobile** - Mobile-specific image

    **Video mobile** - Mobile-specific video

    **External video mobile** - Mobile-specific external video

    **Show controls on video mobile** - Mobile video controls (default: false)

    <Note>
      Mobile media overrides desktop media when set, allowing device-optimized visuals.
    </Note>

    <img src="https://mintcdn.com/digifist/JAX1ZL2jzyduQMK4/images/theme/release/sections/page-banner/mobile-settings.png?fit=max&auto=format&n=JAX1ZL2jzyduQMK4&q=85&s=461169467f763e61ad61295075e252e7" alt="Mobile settings" width="3280" height="2186" data-path="images/theme/release/sections/page-banner/mobile-settings.png" />
  </Tab>

  <Tab title="Settings">
    ### Section container width

    Maximum width of the section.

    **Available options:** Page, Narrow, Narrower, Fluid

    **Default:** Narrow

    ### Color scheme

    Background and text colors when no media is present.

    * Shopify color scheme selector
    * **Default:** Scheme 3

    ### Color scheme for media

    Colors used when media is present.

    * **Default:** Scheme 1

    ### Spacing top

    Controls spacing above the section.

    **Available options:** No, S, M, L, XL

    **Default:** M

    ### Spacing bottom

    Controls spacing below the section.

    **Available options:** No, S, M, L, XL

    **Default:** XL

    <img src="https://mintcdn.com/digifist/JAX1ZL2jzyduQMK4/images/theme/release/sections/page-banner/section-settings.png?fit=max&auto=format&n=JAX1ZL2jzyduQMK4&q=85&s=7cc5ac2c25c67ac6bf987d0bfc40cd5c" alt="Section settings" width="3280" height="2186" data-path="images/theme/release/sections/page-banner/section-settings.png" />
  </Tab>
</Tabs>

## Best practices

* Use background media position with fixed heights (50svh, 100svh) for consistent, impactful banners
* Enable transparent header on first section only for seamless design
* Keep content width at 50-100% for optimal readability across devices
* Use auto height with top/bottom media positions to avoid awkward spacing
* Provide mobile-specific media for better performance and appropriate framing
* Test transparent header with different color schemes to ensure text visibility
* Avoid external videos when possible due to performance concerns; use uploaded videos instead
* Enable breadcrumbs for improved navigation and SEO
* Match collection menu link names exactly with collection handles
* Use center alignment for hero-style banners, start alignment for content-heavy pages

## Common use cases

* **Homepage hero** - Full-height banner with transparent header
* **Collection pages** - Medium-height banner with collection title and description
* **Product category pages** - Branded banners with category information
* **Blog index pages** - Editorial-style headers with featured images
* **About/contact pages** - Custom branded headers with company imagery
* **Landing pages** - Campaign-specific banners with conversion-focused messaging
* **Store information** - Location or brand story headers

## Related guides

<Card title="Common Settings" icon="sliders" href="/themes/release/common-settings">
  Learn about common settings shared across sections
</Card>
