> For the complete documentation index, see [llms.txt](https://docs.kaliumtheme.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kaliumtheme.com/post-types/portfolio/creating-a-portfolio-item/carousel.md).

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