Image viewer
Click an image in any view (or focus it and press Enter or Space) to open it full size in the image viewer. The viewer steps through every image in the gallery, including those on other pages when pagination is on, and wraps around at the ends.
Controls
| Control | Action |
|---|---|
| ‹ / ›, or ← / → | Previous / next image |
| ▶ / ⏸ | Start or pause a slideshow (4 seconds per image). Moving to another image by hand pauses it. |
| ➖ / ➕, or the mouse wheel over the image | Zoom out / in |
| Drag the image | Move around a zoomed image |
| 🔄 | Reset the zoom |
| ℹ️ | Show or hide details: name, path, source type, caption, and size when known |
| 🔗 | Open the image in a new tab (or save it) |
| ×, Esc, or a click outside the image | Close the viewer |
Keyboard in the gallery
- Thumbnail view: ← / → move between tiles; Enter or Space opens the focused one.
- Masonry, justified and embed views: Tab moves between images; Enter or Space opens one.
- Carousel view: with the carousel focused, ← / → change the slide. You can also use the arrow buttons, the dots under the slides, or swipe on a touch screen.
Captions
Captions show under the images (over them on hover in the justified view) and in the viewer's details. Where they come from:
| Source | Caption |
|---|---|
external | The caption of a { url, caption } entry, otherwise the file name |
immich, immich-share | The photo's description in Immich, otherwise the file name |
local, nextcloud, nextcloud-share | The file name |
Turn captions off, or change how many lines they may use, in Settings.