---
title: "Gallery UI: anatomy, variants and examples | Kombai"
description: "A gallery lays out many images in a grid people can scan at a glance, and opens any one of them larger."
canonical_url: https://kombai.com/glossary/gallery/
author: "The Kombai Team"
---

# Gallery

A gallery lays out many images in a grid people can scan at a glance, and opens any one of them larger.

- Also called: image grid
- Platforms: Web, Mobile
- In the Kombai gallery: [52 web designs](https://kombai.com/gallery/web/gallery/), [30 mobile designs](https://kombai.com/gallery/mobile/gallery/)

- [Marlwick](https://kombai.com/gallery/inspirations/gallery-web-2/) (Web)
- [Emquad](https://kombai.com/gallery/inspirations/gallery-ios-21/) (Mobile)
- [Quirefold](https://kombai.com/gallery/inspirations/gallery-web-3/) (Web)

## What is a gallery?

A gallery is a grid of images, or of cards led by images, that people browse by looking rather than reading. The tiles are small so many fit on screen, and selecting one opens it larger, often in a viewer that steps through the rest.

- Images do the work: captions are short or left off entirely.
- Tiles share one size in an even grid, or keep their own shape in a masonry layout.

## When to use gallery

- **The image is the content.** Photos, artwork, references and portfolios people judge by eye.
- **Many images of one thing.** A listing, a product or a place with a dozen photos or more.
- **Picking images.** Choosing photos to attach, covers to use or topics to follow.

## When not to use one

- **Items people read.** Articles and messages need their titles. Use a stacked list or cards.
- **Comparing details.** Specs and prices side by side belong in a table.
- **Only two or three images.** A single large image or a short carousel shows them better.

## Anatomy

1. **Grid**: Rows of tiles that wrap
2. **Thumbnail**: A button that shows the photo
3. **Count**: Position, like "2 of 6"
4. **Viewer**: One image, large
5. **Controls**: Previous, next and full size
6. **States**: Rest, hover, focus, selected

## Variants

We sorted every gallery design in the Kombai gallery and found six patterns.

### 1. Even grids

Square or same-ratio tiles in tidy rows, two or three across on a phone. Common on photo tabs and in photo libraries.

- [Photos](https://kombai.com/gallery/inspirations/gallery-ios-27/) (Mobile)
- [Kilnwright](https://kombai.com/gallery/inspirations/gallery-web-29/) (Web)
- [Gadleigh](https://kombai.com/gallery/inspirations/gallery-web-49/) (Web)

### 2. Masonry

Columns of images that keep their own heights, so portrait and landscape work sit together without cropping.

- [Search risograph](https://kombai.com/gallery/inspirations/gallery-ios-2/) (Mobile)
- [Aventurine](https://kombai.com/gallery/inspirations/gallery-ios-4/) (Mobile)
- [Tannvale](https://kombai.com/gallery/inspirations/gallery-web-23/) (Web)

### 3. Photo mosaics

One large photo beside a block of smaller ones, with a button to see all of them. Common at the top of listings.

- [Hivestead](https://kombai.com/gallery/inspirations/gallery-web-18/) (Web)
- [Quoinstead](https://kombai.com/gallery/inspirations/gallery-web-30/) (Web)
- [Solstace](https://kombai.com/gallery/inspirations/gallery-ios-12/) (Mobile)

### 4. Photo pickers

A grid where tapping a tile selects it, with a check on each pick and a count of how many are chosen.

- [Corymbe](https://kombai.com/gallery/inspirations/gallery-ios-19/) (Mobile)
- [Quirefold](https://kombai.com/gallery/inspirations/gallery-ios-24/) (Mobile)
- [Pick Reference](https://kombai.com/gallery/inspirations/gallery-web-32/) (Web)

### 5. Collections

Boards or folders shown as a cluster of their first few images, with a name and a count under each.

- [Firnvale](https://kombai.com/gallery/inspirations/gallery-ios-26/) (Mobile)
- [Your Yard](https://kombai.com/gallery/inspirations/gallery-web-46/) (Web)
- [Feltside](https://kombai.com/gallery/inspirations/gallery-web-4/) (Web)

### 6. Topic tiles

Photo tiles labeled with an interest or a craft, picked during onboarding to shape what people see.

- [Corriecraft](https://kombai.com/gallery/inspirations/gallery-ios-28/) (Mobile)
- [Firnwick](https://kombai.com/gallery/inspirations/gallery-ios-29/) (Mobile)
- [Coppicehall](https://kombai.com/gallery/inspirations/gallery-web-36/) (Web)

## Where galleries show up

### Places and stays

Hotel, landmark and garden pages that lead with photos before the details and the booking button.

- [Solvard Hotel Kestrelby](https://kombai.com/gallery/inspirations/gallery-web-20/) (Web)
- [Nethercomb Water Meadows](https://kombai.com/gallery/inspirations/gallery-web-27/) (Web)
- [Meridiel Botanic Reserve](https://kombai.com/gallery/inspirations/gallery-ios-13/) (Mobile)

### AI image tools

Generated images laid out as a grid of results, so people can compare takes and pick one to refine.

- [Sporelume](https://kombai.com/gallery/inspirations/gallery-web-11/) (Web)
- [Coppicant](https://kombai.com/gallery/inspirations/gallery-web-47/) (Web)
- [Cerelume Studio](https://kombai.com/gallery/inspirations/gallery-web-38/) (Web)

### Portfolios

A studio, a maker or a workshop showing its work as one grid, with little else on the page.

- [Cygnara](https://kombai.com/gallery/inspirations/gallery-ios-14/) (Mobile)
- [Archive](https://kombai.com/gallery/inspirations/gallery-web-25/) (Web)
- [Randmoor Careers](https://kombai.com/gallery/inspirations/gallery-web-48/) (Web)

## Gallery vs similar components

| | [Gallery](https://kombai.com/glossary/gallery/) | [Carousel](https://kombai.com/glossary/carousel/) | [Card](https://kombai.com/glossary/card/) |
|---|---|---|---|
| Shows | Many images at once | A few items at a time | One item per framed block |
| Layout | An even or masonry grid | One scrolling row | Grid, rail or stack |
| Best for | Photos, portfolios and references | Short, optional sets | Mixed content with text and actions |

## Build notes

- Make each thumbnail a <button> or a link to the full image, and give it alt text that describes the photo.
- Use alt="" only for images that are pure decoration.
- Open the large view in a <dialog> with showModal(), so focus moves into it and Escape closes it.
- When the viewer closes, return focus to the thumbnail that opened it.
- Set width and height on every image, so the grid holds its shape while images load.
- Add loading="lazy" to images below the fold, and serve small files in the grid.

## FAQ

### Grid or masonry?

An even grid suits images of the same kind, like product shots, and lines up cleanly. Masonry keeps each image in its own shape, so it suits mixed portrait and landscape work like moodboards. Its order is harder to follow, so skip it when the order matters.

### Should gallery images open in a lightbox?

Yes, when people need detail. Open the image large over the page, let people step through with arrows, keys or a swipe, and close back to the same spot in the grid with focus on the photo they opened.

### How do you keep a large image gallery fast?

Serve small thumbnails in the grid and the full image only in the viewer. Lazy-load images below the fold with loading="lazy", and give every image a width and height so the page does not shift as they arrive.

### Do gallery images need alt text?

Yes, when the image carries meaning, which in a gallery it nearly always does. Describe what the photo shows in a short phrase. An empty alt="" marks an image as decoration that non-visual browsers may skip, so keep it for that.

## Related terms

- [Carousel](https://kombai.com/glossary/carousel/)
- [Card](https://kombai.com/glossary/card/)
- [Bento grid](https://kombai.com/glossary/bento-grid/)
- [File upload](https://kombai.com/glossary/file-upload/)

## References

- [MDN: The dialog element](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dialog)
- [WAI-ARIA Authoring Practices: Dialog (modal) pattern](https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/)
- [MDN: The image embed element](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img)
