# Carousel

The Carousel item type offers a dynamic full-width gallery experience by showcasing images in a carousel format. This layout allows you to feature images in a slideshow that spans the entire width of the page. 

You can customize various carousel settings to control the display and behavior of the carousel. This layout type supports images only as gallery items.

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

## Carousel Options

Here, you can configure the layout options for the carousel, which can be set to either **Default Layout** or **Centered Content Layout**, apart from other project gallery options.

<figure><img src="/files/3QQxyy5cM4vPJmF86RYY" alt=""><figcaption></figcaption></figure>

### Content Alignment

You can choose between two layout types: **Default Layout** and **Centered Content Layout**. These options allow you to align the content either to the left or center it within the page.

<div><figure><img src="/files/FyA7BHzDUFmMP9XvFzia" alt="" width="375"><figcaption><p>Left alignment (Right in RTL)</p></figcaption></figure> <figure><img src="/files/i3eR69hznOYTTgcdHbjL" alt="" width="375"><figcaption><p>Centered content alignment</p></figcaption></figure></div>

### Carousel Items Alignment

The gallery items can have a starting position that can be either **Left** (default) or **Center**:

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

The starting position of gallery items determines the placement of the first image relative to the center of the viewport:

<div><figure><img src="/files/xvBnA7T4vLhL9mnOhgu9" alt="" width="375"><figcaption><p>Left start position</p></figcaption></figure> <figure><img src="/files/C0i17EyKzjKI66l7vGbt" alt="" width="375"><figcaption><p>Center start position</p></figcaption></figure></div>

{% hint style="info" %}
Note that setting **Carousel Start Position** to **Center** and having **Infinite Loop Slides** enabled will not work.
{% endhint %}

## Project Gallery

The **Project Gallery** for the Carousel item type supports images only. The gallery container has the following options:

* **Reveal Effect**: Select the animation or transition effect for revealing gallery items.
* **Spacing**: Adjust the space between images to fit your layout.
* **Captions**: Toggle captions on or off for the gallery images.
* **Maximum Carousel Height**: Set the maximum height for the carousel.
* **Carousel Content Start Position**: Choose to start from the center or left.
* **Loop**: Enable infinite looping of slides.
* **Autoplay**: Set the carousel to autoplay with a specified time interval.
* **Items Gap**: Define the gap between items for the desired visual effect.

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

To insert a new carousel item, click **Add New** and select the **Image** type.&#x20;

Each field contains the information regarding its functionality, making it easy to add and configure your images for the carousel.


---

# 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://docs.kaliumtheme.com/post-types/portfolio/creating-a-portfolio-item/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.