---
title: Image Gallery
description: Showcasing the built-in image gallery support
date: 2026-01-26
slug: image-gallery
image: helena-hertz-wWZzXlDpMog-unsplash.jpg
categories:
    - Documentation
tags:
    - Gallery
    - Photoswipe
toc: false
---

Stack theme has a built-in support for image galleries. It allows you to create a beautiful gallery by simply placing multiple images side-by-side.

## Sample Gallery

![Photo by Florian Klauer on Unsplash](florian-klauer-nptLmg6jqDo-unsplash.jpg)  ![Photo by Luca Bravo on Unsplash](luca-bravo-alS7ewQ41M8-unsplash.jpg) 

![Photo by Helena Hertz on Unsplash](helena-hertz-wWZzXlDpMog-unsplash.jpg)  ![Photo by Hudai Gayiran on Unsplash](hudai-gayiran-3Od_VKcDEAA-unsplash.jpg)

## How it works

The gallery is powered by **Photoswipe** and a custom internal script. It automatically calculates the best layout for your images based on their aspect ratios.

To create a gallery, you just need to put multiple images in the same line (or paragraph).

### Syntax

```markdown
![Image 1](image1.jpg)  ![Image 2](image2.jpg)

![Image 3](image3.jpg)  ![Image 4](image4.jpg)
```

> **Note**: There should be two spaces between the images to ensure they stay in the same line in Markdown

---

Gallery Syntax inspired by [Typlog](https://typlog.com/)