# Slideshow

A **Slideshow** on a website serves to visually engage users, highlight content, convey stories, and drive user interaction. It enhances the website's visual appeal and user engagement, making it an effective tool for promoting products and conveying brand identity.

<figure><img src="/files/Ggd3fOJE76qVRTEBAPBQ" alt=""><figcaption></figcaption></figure>

## Section settings

### General setting

<table data-full-width="false"><thead><tr><th width="154">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Section width</strong></td><td><p></p><p>3 options for container</p><ul><li><em><strong>Stretch width</strong></em>: span the section width regardless of screen size.</li><li><em><strong>Fix width</strong></em>: depends on your page content width in <strong>Theme settings</strong> <strong>-></strong> <strong>Layout</strong>.</li><li><em><strong>Expand full width</strong></em>: takes up the entire space on the page and it usually resizes itself to fit the size of the screen.</li></ul></td></tr><tr><td><strong>Color scheme</strong></td><td>Select colors from <strong>Theme settings -> Colors</strong></td></tr></tbody></table>

### Content

**Size:** Customize the font size of the content with 3 options

* Small
* Medium
* Large

### Settings for carousel

<table data-full-width="false"><thead><tr><th width="143">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Show navigation</strong></td><td>Display the next and back controls for the carousel</td></tr><tr><td><strong>Show pagination</strong></td><td>Display the pagination for the carousel</td></tr><tr><td><strong>Desktop pagination position</strong></td><td><p>Customize the position of the pagination</p><ul><li>Left</li><li>Center</li><li>Right</li></ul></td></tr><tr><td><strong>Auto-change slide</strong></td><td>When enabled, the slideshow will automatically transition</td></tr><tr><td><strong>Change slides every</strong></td><td>Customize the time interval between slide transitions, measured in seconds</td></tr></tbody></table>

### Slide height

**Image height:** Adjust the height of the slide images

* Full screen
* Adapt to image
* Small
* Medium
* Large

### Mobile layout

* **Show text bellow on mobile:** Content beneath the image
* **Reset color scheme setting on mobile:** When enabled, the content color will be displayed in the default color scheme

### Section padding

* **Top padding:** Customize the top margin of the section
* **Bottom padding:** Customize the bottom margin of the section

## Block settings

<table data-full-width="false"><thead><tr><th width="143">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Image</strong></td><td>Upload desktop slide image, and it will be displayed for mobile if no mobile image is uploaded</td></tr><tr><td><strong>Mobile image</strong></td><td>Upload mobile slide image</td></tr><tr><td><strong>Image overlay opacity</strong></td><td>Customize the image overlay opacity</td></tr><tr><td><strong>Subheading</strong></td><td>Subheading content</td></tr><tr><td><strong>Heading</strong></td><td>Heading content</td></tr><tr><td>Description</td><td>Description content</td></tr><tr><td><strong>Button label</strong></td><td>Button content</td></tr><tr><td><strong>Button link</strong></td><td>The link URL you want to add</td></tr><tr><td><strong>Button style</strong></td><td><p>The style of the button</p><ul><li>Fill</li><li>Outline</li></ul></td></tr><tr><td><strong>Desktop content position</strong></td><td><p>9 options for the desktop content position</p><ul><li>Top left</li><li>Top center</li><li>Top right</li><li>Middle left</li><li>Middle center</li><li>Middle right</li><li>Bottom left</li><li>Bottom center</li><li>Bottom right</li></ul></td></tr><tr><td><strong>Content alignment</strong></td><td><p>3 options for the content alignment</p><ul><li>Left</li><li>Center</li><li>Right</li></ul></td></tr></tbody></table>

{% hint style="info" %}
**Note**: For text input fields, leave them blank if you don't want to display
{% endhint %}


---

# 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://nextsky.gitbook.io/agile-theme/sections/slideshow.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.