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

![Hero Banner section overview](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)

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

**1. Open Theme Customizer**

From Shopify admin, access the Theme Customizer.

**2. Add Hero Banner section**

Add the Hero Banner section to your page or template.

**3. Add slides**

Click **Add Slide** to create banner content.

**4. Configure settings**

Adjust section and slide settings according to your needs.

![Hero Banner section in Theme Customizer](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)

## Section settings

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

> [tab] 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.
>
> ![Enable transparent header setting](https://mintcdn.com/digifist/l5801AUoh95gHg1X/images/theme/release/sections/hero-banner/transparent-header.png?fit=max\&auto=format\&n=l5801AUoh95gHg1X\&q=85\&s=7470e35f105137c0f0394348e2131044)

> [tab] 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.
>
> ### 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
>
> ![Slideshow navigation and pagination settings](https://mintcdn.com/digifist/L0WqNhK1hpnQTvQQ/images/theme/release/sections/hero-banner/slideshow-settings.png?fit=max\&auto=format\&n=L0WqNhK1hpnQTvQQ\&q=85\&s=c036e9f115f0e5bb4d661b5eb7efeb47)

> [tab] 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.

## Block settings

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

> [tab] Layout & Style
>
> ### Banner layout
>
> Controls how content and media are distributed within the slide.
>
> **Available options:** Full, 70 / 30, 30 / 70, Split
>
> ![Banner layout options](https://mintcdn.com/digifist/l5801AUoh95gHg1X/images/theme/release/sections/hero-banner/banner-layout.png?fit=max\&auto=format\&n=l5801AUoh95gHg1X\&q=85\&s=dcea33ac3fb30ef66a3220e01abf9b57)
>
> ### 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] 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.
>
> > [accordion] First button
> >
> > * **Link:** Destination URL
> > * **Link type:** Button / Card
> > * **Label:** Leave empty to hide the button
> > * **Style:** Filled, Outlined, Text
>
> > [accordion] Second button
> >
> > * **Link:** Destination URL
> > * **Link type:** Button / Card
> > * **Label:** Leave empty to hide the button
> > * **Style:** Filled, Outlined, Text

> [tab] Desktop media
>
> ### Content position
>
> Controls vertical alignment.
>
> **Options:** Top, Center, Bottom
>
> ### Content alignment
>
> Controls horizontal alignment.
>
> **Options:** Start, Center, End
>
> ![Content position and alignment settings](https://mintcdn.com/digifist/l5801AUoh95gHg1X/images/theme/release/sections/hero-banner/content-position.png?fit=max\&auto=format\&n=l5801AUoh95gHg1X\&q=85\&s=00cdfdf7e09112c433f75c36a11d42a5)
>
> ### 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.
>
> ### Show video controls
>
> Shows or hides video playback controls.
>
> ### Enable overlay
>
> Adds a visual overlay on top of the media to improve text contrast.
>
> ![Enable overlay setting for desktop](https://mintlify.s3.us-west-1.amazonaws.com/digifist/images/theme/release/sections/hero-banner/enable-overlay.png)

> [tab] Mobile media
>
> > [!NOTE]
> >
> > If mobile media is set, it will be used on mobile devices instead of the main media.
>
> ### 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.
>
> ### Show video controls
>
> Shows or hides video playback controls on mobile.
>
> ### Enable overlay
>
> Adds a visual overlay on mobile media.
>
> ![Mobile-specific media settings](https://mintlify.s3.us-west-1.amazonaws.com/digifist/images/theme/release/sections/hero-banner/mobile-settings.png)

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

> [card] [Header section](https://docs.digifist.com/themes/release/header.md)
>
> Learn about header configuration and transparent header behavior

> [card] [Theme settings](https://docs.digifist.com/themes/release/theme-settings/index.md)
>
> Understand global theme configuration options


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.