> For the complete documentation index, see [llms.txt](https://flexi-library.gitbook.io/flexi-sections/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://flexi-library.gitbook.io/flexi-sections/sections/hero-and-banners/hero-slideshow.md).
# Hero Slideshow
The **Hero Slideshow** section creates a full-width, rotating hero carousel with one slide visible at a time—ideal for homepage banners, campaign launches, or any spot where you want multiple hero messages in a single section. Add **Hero slide** blocks inside the **Hero slideshow layout**, each with its own background image, optional color overlay, subheading, heading, description, and call-to-action button. Position content anywhere on the slide (top, center, or bottom in nine alignment options), control text alignment and color, and set custom or hug slide heights with separate desktop and mobile minimums. The slideshow supports dot pagination, navigation arrows (middle overlay or bottom-right), autoplay with custom timing, loop, and touch dragging—all configurable in the Theme Editor. Control section width (fixed, full, or theme-native containers for Dawn, Horizon, or custom themes), section background colors or images with overlay, spacing, and scroll animations without writing any code. It works with any Shopify 2.0 theme and is perfect for rotating promotions, seasonal campaigns, or multi-message homepage heroes.
### Setup Instructions
{% stepper %}
{% step %}
**Install the App**
Visit the Shopify App Store and install Flexi Slider Sections. Start your free trial to access all features and sections.
{% endstep %}
{% step %}
**Install Section**
Open the Flexi app and navigate to the sections library. Search for "Hero Slideshow" and click "Add to Theme" to install it instantly.
{% endstep %}
{% step %}
**Add to Your Store**
Go to your Shopify admin → Online Store → Themes → Customize. Click "Add section" and select "Hero Slideshow" from the available sections.
{% endstep %}
{% step %}
**Set Section Width**
In the section settings, choose your preferred layout:
* **Fixed**: Set a custom maximum width (320px - 1440px)
* **Full**: Spans the entire page width
* **Custom Theme**: Use your theme's page width class (e.g. `section` on Horizon)
* **Dawn Theme** / **Horizon Theme**: Match those theme container widths
{% endstep %}
{% step %}
**Add Content**
Inside the **Hero slideshow layout** block, click "Add block" to add **Hero slide** blocks. For each slide, upload a background image and add your subheading, heading, description, and button. Add as many slides as you need—the slideshow cycles through them one at a time.
{% endstep %}
{% step %}
**Customize & Style**
Fine-tune the slideshow with the built-in settings:
* Adjust section background colors or background images with overlay opacity
* Control section spacing and slide min heights (desktop and mobile)
* Set content position, text alignment, and button style on each slide
* Configure dot pagination color, arrow position, autoplay, loop, and drag behavior
{% endstep %}
{% endstepper %}
{% hint style="info" %}
#### Why Use Flexi Sections?
**Designed to Feel Native**\
Flexi sections are built to inherit your theme’s structure and styles, so they blend in naturally instead of feeling bolted on. Spend less time overriding CSS and more time shipping polished layouts that feel intentional.
**Prebuilt, Not Prescriptive**\
Each section provides a production-ready foundation without locking you into rigid layouts. Configure content, spacing, and structure to match your client’s needs—without rebuilding the same patterns from scratch.
**Theme-First Customization**\
All styling and layout adjustments happen through the Shopify Theme Editor. Tweak typography, spacing, alignment, and behavior using familiar theme controls, just like native sections.
**Built for Performance & SEO**\
Flexi sections are optimized for real storefronts, not demos. Lightweight markup and thoughtful defaults help keep pages fast, stable, and search-friendly across devices.
**Works Across Any Shopify Theme**\
Flexi sections work with any Shopify 2.0 theme, including Dawn, Horizon, and custom builds. Test safely on duplicate themes and ship with confidence.
**Easy to Maintain Over Time**\
Once a section is in place, it’s easy to manage. Update content, swap images, or adjust layout directly in the Shopify admin—no fragile custom code or one-off fixes to maintain later.
**Built for Reuse Across Projects**\
Flexi is designed for builders shipping real work. Reuse the same section patterns across client projects to stay consistent, move faster, and avoid unnecessary technical debt.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://flexi-library.gitbook.io/flexi-sections/sections/hero-and-banners/hero-slideshow.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.