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

# Hero Banner

> Create large, visually impactful banners with support for slideshows, images, and videos.

The Hero Banner section creates prominent visual displays at the top of a page. It supports static banners, slideshows, images, and videos, and can interact with the header when positioned as the first section on a page.

Hero banners help establish visual hierarchy and communicate key messages or campaigns immediately upon page load.

<img src="https://mintcdn.com/digifist/Wq2qVAAr4VDjAzAh/images/theme/release/sections/hero-banner/hero-banner-overview.jpg?fit=max&auto=format&n=Wq2qVAAr4VDjAzAh&q=85&s=254c9952e5e7d5f075bd468d8601d0c7" alt="Hero Banner section overview" width="3280" height="2162" data-path="images/theme/release/sections/hero-banner/hero-banner-overview.jpg" />

## What this section controls

This section controls large banner areas with the following capabilities:

* Visual slideshows with multiple media types
* Transparent header integration when placed first on a page
* Desktop and mobile-specific media and positioning
* Interactive elements including buttons and video controls

## How the Hero Banner works

The Hero Banner uses a block-based system:

* Each **slide** is created as a block inside the Hero Banner section
* Multiple slides automatically form a **slideshow**
* When placed as the **first section on the page**, the Hero Banner can enable a transparent header

## Getting started

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

  <Step title="Add Hero Banner section">
    Add the Hero Banner section to your page or template.
  </Step>

  <Step title="Add slides">
    Click **Add Slide** to create banner content.
  </Step>

  <Step title="Configure settings">
    Adjust section and slide settings according to your needs.
  </Step>
</Steps>

<img src="https://mintcdn.com/digifist/l5801AUoh95gHg1X/images/theme/release/sections/hero-banner/hero-banner-location.png?fit=max&auto=format&n=l5801AUoh95gHg1X&q=85&s=3267e19cec32bae3e8ef17cf6b9bfbcd" alt="Hero Banner section in Theme Customizer" width="3280" height="2186" data-path="images/theme/release/sections/hero-banner/hero-banner-location.png" />

## Section settings

Section settings control the global behavior of the Hero Banner and apply to all slides.

<Tabs>
  <Tab title="Header integration">
    ### Enable transparent header

    When enabled, the header becomes transparent **only if this section is the first section on the page**.

    This allows the Hero Banner media to appear behind the header.

    <Warning>
      This setting is only used when this section is the first one in the page order. Ensure the banner has sufficient contrast for navigation visibility.
    </Warning>

    <img src="https://mintcdn.com/digifist/l5801AUoh95gHg1X/images/theme/release/sections/hero-banner/transparent-header.png?fit=max&auto=format&n=l5801AUoh95gHg1X&q=85&s=7470e35f105137c0f0394348e2131044" alt="Enable transparent header setting" width="3280" height="2186" data-path="images/theme/release/sections/hero-banner/transparent-header.png" />
  </Tab>

  <Tab title="Slideshow">
    ### Hero height

    Controls the height of the hero section.

    **Range:** 0% – 100%

    ### Slideshow autoplay interval

    Controls how often slides change automatically.

    **Range:** 0 – 60 seconds

    * `0` disables autoplay
    * Any value above `0` enables autoplay

    ### Show slideshow navigation

    Displays slideshow navigation arrows on desktop devices.

    <Note>
      Navigation arrows are not shown on mobile.
    </Note>

    ### Slideshow navigation position

    Controls the position of navigation arrows.

    **Available options:** Sides, Start, Center

    ### Color scheme for arrows

    Controls the color scheme used for slideshow navigation arrows.

    ### Show slideshow pagination

    Displays slideshow pagination indicators.

    Pagination is visible on both desktop and mobile.

    ### Slideshow pagination style

    Controls the visual style of pagination indicators.

    **Available options:** Style 1, Style 2

    <img src="https://mintcdn.com/digifist/L0WqNhK1hpnQTvQQ/images/theme/release/sections/hero-banner/slideshow-settings.png?fit=max&auto=format&n=L0WqNhK1hpnQTvQQ&q=85&s=c036e9f115f0e5bb4d661b5eb7efeb47" alt="Slideshow navigation and pagination settings" width="3280" height="2186" data-path="images/theme/release/sections/hero-banner/slideshow-settings.png" />
  </Tab>

  <Tab title="Advanced">
    ### Floating bar

    Enables the floating bar behavior when a **Marquee section** is added directly after the Hero Banner section.

    <Note>
      This setting has no effect unless a marquee section exists below the hero.
    </Note>
  </Tab>
</Tabs>

## Block settings

Block settings control the layout, content, and media of each individual slide. Each slide represents one banner within the hero area.

<Tabs>
  <Tab title="Layout & Style">
    ### Banner layout

    Controls how content and media are distributed within the slide.

    **Available options:** Full, 70 / 30, 30 / 70, Split

    <img src="https://mintcdn.com/digifist/l5801AUoh95gHg1X/images/theme/release/sections/hero-banner/banner-layout.png?fit=max&auto=format&n=l5801AUoh95gHg1X&q=85&s=dcea33ac3fb30ef66a3220e01abf9b57" alt="Banner layout options" width="3280" height="2186" data-path="images/theme/release/sections/hero-banner/banner-layout.png" />

    ### Color scheme

    Controls the background and text colors for the slide using Shopify's color scheme system.

    ### Header menu color

    When the header is transparent, this setting controls the color of header navigation links for better contrast.
  </Tab>

  <Tab title="Content">
    ### Heading

    Main heading text for the slide.

    ### Subheading

    Secondary heading text displayed below the main heading.

    ### Subheading link

    Optional link applied to the subheading text.

    ### Text

    Supporting body text displayed within the slide.

    ## Buttons

    Slides support up to two buttons.

    <AccordionGroup>
      <Accordion title="First button" icon="1">
        * **Link:** Destination URL
        * **Link type:** Button / Card
        * **Label:** Leave empty to hide the button
        * **Style:** Filled, Outlined, Text
      </Accordion>

      <Accordion title="Second button" icon="2">
        * **Link:** Destination URL
        * **Link type:** Button / Card
        * **Label:** Leave empty to hide the button
        * **Style:** Filled, Outlined, Text
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Desktop media">
    ### Content position

    Controls vertical alignment.

    **Options:** Top, Center, Bottom

    ### Content alignment

    Controls horizontal alignment.

    **Options:** Start, Center, End

    <img src="https://mintcdn.com/digifist/l5801AUoh95gHg1X/images/theme/release/sections/hero-banner/content-position.png?fit=max&auto=format&n=l5801AUoh95gHg1X&q=85&s=00cdfdf7e09112c433f75c36a11d42a5" alt="Content position and alignment settings" width="3280" height="2186" data-path="images/theme/release/sections/hero-banner/content-position.png" />

    ### Image

    Main image used for the slide on desktop.

    ### Video

    Video file used instead of the image.

    ### External video

    Overrides both image and video.

    <Warning>
      External videos may negatively impact performance. For best results, use the built-in video option.
    </Warning>

    ### Show video controls

    Shows or hides video playback controls.

    ### Enable overlay

    Adds a visual overlay on top of the media to improve text contrast.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/digifist/images/theme/release/sections/hero-banner/enable-overlay.png" alt="Enable overlay setting for desktop" />
  </Tab>

  <Tab title="Mobile media">
    <Note>
      If mobile media is set, it will be used on mobile devices instead of the main media.
    </Note>

    ### Content position

    Controls vertical alignment on mobile.

    **Options:** Top, Center, Bottom

    ### Content alignment

    Controls horizontal alignment on mobile.

    **Options:** Start, Center, End

    ### Image

    Image used for the slide on mobile devices.

    ### Video

    Video used for the slide on mobile devices.

    ### External video

    Overrides both image and video on mobile.

    <Warning>
      External videos may negatively impact performance.
    </Warning>

    ### Show video controls

    Shows or hides video playback controls on mobile.

    ### Enable overlay

    Adds a visual overlay on mobile media.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/digifist/images/theme/release/sections/hero-banner/mobile-settings.png" alt="Mobile-specific media settings" />
  </Tab>
</Tabs>

## Best practices

* Use the Hero Banner as the first section to enable transparent headers
* Avoid external videos unless necessary due to performance impact
* Ensure sufficient contrast when using transparent headers for navigation visibility
* Keep slide content concise for better readability and faster comprehension
* Limit the number of slides to maintain performance and prevent user fatigue
* Test mobile and desktop layouts separately to ensure optimal presentation
* Use high-quality images that maintain clarity at large sizes

## Related guides

<CardGroup cols={2}>
  <Card title="Header section" icon="arrow-up-from-bracket" href="/themes/release/header">
    Learn about header configuration and transparent header behavior
  </Card>

  <Card title="Theme settings" icon="sliders" href="/themes/release/theme-settings/index">
    Understand global theme configuration options
  </Card>
</CardGroup>
