> 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/lightbox.md).

# Lightbox

Open media straight in an overlay, with no project page.

The Lightbox item type displays your media directly in a lightbox view, offering an engaging way to showcase images or videos with overlay effects. Users can view content in a larger, focused format.

This item type is designed to open directly from the [Portfolio Page](/post-types/portfolio/portfolio-page.md) (portfolio archive) and can also be accessed on a single portfolio item page through portfolio item link.

<figure><img src="https://2905187046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1O25QgF7NUwiK2Ek4ro8%2Fuploads%2Fgit-blob-652968018954b35205319b713917d843804e86f8%2FLightbox%20-%20Preview.jpg?alt=media" alt=""><figcaption></figcaption></figure>

## Lightbox Options

This type supports both images and videos in lightbox. You can customize the lightbox behavior by displaying the *featured image*, *a custom assigned image*, *a set of images and/or videos*, or *a single video* from sources like *YouTube*, *Vimeo*, or *self-hosted*.

### Featured Image

By default, this item type uses the featured image assigned for the lightbox, requiring no additional configuration.

<figure><img src="https://2905187046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1O25QgF7NUwiK2Ek4ro8%2Fuploads%2Fgit-blob-0de0bc0cdde563c55f679b09b5dedc56e38f7b51%2FLightbox%20-%20Content%20to%20Show%20-%20Featured%20Image.jpg?alt=media" alt=""><figcaption></figcaption></figure>

### Custom Image

This option lets you set a single custom image for the portfolio item. In the [Portfolio Page](/post-types/portfolio/portfolio-page.md) (portfolio archive), the featured image is displayed, but when the lightbox opens, the image assigned in this field will be shown.

<figure><img src="https://2905187046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1O25QgF7NUwiK2Ek4ro8%2Fuploads%2Fgit-blob-05ec00d751fc93abe7eab357fe1e9cf09863d4b4%2FLightbox%20-%20Content%20to%20Show%20-%20Custom%20Image.jpg?alt=media" alt=""><figcaption></figcaption></figure>

### Video Content

Shows a video from any supported source (*YouTube*, *Vimeo* or *self-hosted*) in lightbox. A **Video Poster** field sets the still image shown before playback starts.

<figure><img src="https://2905187046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1O25QgF7NUwiK2Ek4ro8%2Fuploads%2Fgit-blob-e26560cfb3baa7993ef714d5cb6e824f4a0fdd0d%2FLightbox%20-%20Content%20to%20Show%20-%20Video.jpg?alt=media" alt=""><figcaption></figcaption></figure>

### Mix of Images and Videos

Selecting **Multiple Images and/or Video Gallery** allows you to display multiple media items in the lightbox.

<figure><img src="https://2905187046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1O25QgF7NUwiK2Ek4ro8%2Fuploads%2Fgit-blob-18054f47ae17a18f4b9d221e39191ff202248015%2FLightbox%20-%20Content%20to%20Show%20-%20Gallery.jpg?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The **Browse Mode** option in **Portfolio Page** settings set items chaining behavior for the lightbox. For more [read here ->](/post-types/portfolio/portfolio-page.md#lightbox-type)
{% endhint %}