# Carousel

The carousel section displays a horizontally scrollable set of slides, allowing you to showcase images, promotions, or content in an interactive format. It is commonly used for storytelling, featured content, or visual highlights that benefit from sequential browsing.

<figure><img src="/files/1cbjaTdeACzaNQP5x4pt" alt=""><figcaption></figcaption></figure>

#### Show header

Controls the visibility of the section header above the carousel. When enabled, the heading and subheading are displayed if set.

#### Heading

The main heading displayed for the section. Default is “Carousel”. Leave blank to omit.

#### Subheading

Optional supporting text shown below the heading to provide context or additional information. Leave blank to omit.

#### Button label

Defines the text for an optional call-to-action button. Leave blank to hide the button.

#### Button link

Specifies the URL destination for the button. Can link to a page, collection, product, or external URL. Leave blank to omit.

#### Button style

Defines the visual style of the button. Default is “Secondary”.

#### Slide aspect ratio (Desktop)

Defines the aspect ratio of carousel slides on desktop devices. Default is 16:9, providing a wide landscape presentation.

#### Slide aspect ratio (Mobile)

Defines the aspect ratio of carousel slides on mobile devices. Default is 1:1 for a square, mobile-optimized layout.

#### Show buttons

Controls when navigation buttons are displayed for the carousel. Default is “Desktop only”.

#### Show pagination

Controls whether pagination indicators are shown for the carousel. Default is “Always”.

#### Vertical spacing

Controls the spacing around the section to adjust its separation from surrounding content.

#### Vertical spacing (desktop)

Sets the vertical spacing applied on desktop devices. Default is Large.

#### Vertical spacing (mobile)

Sets the vertical spacing applied on mobile devices to ensure consistent spacing across screen sizes.


---

# Agent Instructions: 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:

```
GET https://gatame.gitbook.io/highstreet/dynamic-sections/editorial/carousel.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.