Skip to main content
You can add photos and videos through the web app, an Immich client, the API, or an AI assistant. Select the destination library first; you need to own it or have the Collaborator role to upload.

Upload in your browser

Use Upload in the web app to choose files, or Upload folder to choose a folder. Known non-media files are skipped. You can add more files or folders while an upload runs; later batches appear under Up next, where you can remove a batch before it starts. Exact duplicate uploads reuse the existing asset in that library. They do not create a second stored copy.
Illustrative upload card showing photo thumbnails, progress, and an Up next batch

Upload queue example: the current batch runs while another waits under Up next.

Supported files and limits

Gumnut decides whether a file is a photo or video from its filename extension. Files it doesn’t recognize as an image or video are rejected. To keep a RAW photo, export it as JPEG, HEIC, or TIFF first. Videos play back from the original file, so playback depends on your browser or device supporting its codec. The web app skips files that aren’t media before uploading, such as .xmp and .aae sidecars and .DS_Store files, and reports how many it skipped. An image larger than about 179 megapixels still uploads, and you can download the original. Gumnut can’t create a preview for it, though, and won’t detect faces, index it for search, or describe it. Very large images under that size display at a reduced resolution; the original keeps every pixel.

Bring photos from other tools

What happens after upload

Processing continues in the background. Gumnut prepares thumbnails and reads metadata such as capture time, camera details, and location when available. For images, it also detects faces, creates search embeddings, and generates descriptions of visible content. These results can take time to appear. Videos support thumbnails, metadata, and playback of the original file; automatic face, embedding, and description analysis is image-only today. See People, Search, and Map view for ways to explore the results.