From 6e65eff9f34be8bd076e9ba20b7d302f24a582f0 Mon Sep 17 00:00:00 2001 From: Alan Grainger <16197738+alangrainger@users.noreply.github.com> Date: Wed, 7 Oct 2026 18:13:02 +1300 Subject: [PATCH] Update docs --- docs/visitor-uploads.md | 38 +++++++++++++++++++++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) diff --git a/docs/visitor-uploads.md b/docs/visitor-uploads.md index 0f851df..a8e8a3f 100644 --- a/docs/visitor-uploads.md +++ b/docs/visitor-uploads.md @@ -1,7 +1,8 @@ # Let visitors send photos back Visitors to a share can send their own photos and videos into it, for example guests adding their pictures to a -wedding album. The photos go straight into the album in Immich and appear in the gallery for everyone. +wedding album. The photos go straight into the album in Immich and appear in the gallery for everyone, unless you +choose to [review them first](#review-uploads-before-they-appear). This guide assumes IPP is already [installed](/installation) behind a reverse proxy. @@ -16,6 +17,7 @@ This guide assumes IPP is already [installed](/installation) behind a reverse pr - [Set a storage quota](#set-a-storage-quota) - [Request size limits](#request-size-limits) - [Tag uploaded photos](#tag-uploaded-photos) +- [Review uploads before they appear](#review-uploads-before-they-appear) - [Get a notification for each upload](#get-a-notification-for-each-upload) - [Questions](#questions) @@ -237,6 +239,35 @@ uploads, or to copy them into a second album. In Immich, open **Workflows** and 2. Filter: **Filter by filename**, match type `startsWith`, pattern `ipp_upload_`. 3. Action: **Add Tags** with a tag such as `Sent by visitors`, or **Add to Album(s)**. +## Review uploads before they appear + +Immich has no approval queue for uploads through a shared link, but a workflow can move each upload into your +**locked folder** the moment it arrives. IPP never shows a locked photo, so the upload leaves the gallery until you +decide to keep it. This is the staging step: visitors upload, you approve, the gallery updates. + +The locked folder needs a PIN. Set one in your Immich account settings if you have not already. Then create a +workflow as in [Tag uploaded photos](#tag-uploaded-photos), with these actions: + +1. Trigger: **Asset Upload**. +2. Filter: **Filter by filename**, match type `startsWith`, pattern `ipp_upload_`. +3. Action: **Move to locked folder**. Add a second action, **Add Tags**, if you want the approved uploads to stay + easy to find afterwards. + +To review, open the locked folder in Immich and enter your PIN. A photo's info panel lists the album it was sent +to under **Appears in**, since it is still a member while locked. Move the photos you want to keep out of the locked +folder: they return to the gallery on the next cache refresh. Delete the rest. Pair this with a +[notification](#get-a-notification-for-each-upload) so you know when there is something to review; its message names +the share, which is the only record of the destination for a share of individual photos, as those have no album. + +Two things to know: + +- The upload is pulled back, not held back. The workflow runs a few seconds after the file is stored, and IPP + caches a share's photo list for up to 2 minutes, so a visitor who has the gallery open can see the photo for a + short while. Anyone who copied the photo's address in that window can keep opening it until you delete it. +- Keeping a photo relies on Immich leaving it in the album while it is locked, which it does for photos a workflow + moves. If a future Immich version removes it from the album instead, add the approved photos back to the album + by hand. + ## Get a notification for each upload Set [`upload.notifyUrl`](/config/upload-service#notifyurl) to a URL that receives a JSON message for each stored @@ -260,6 +291,11 @@ So a new photo can take up to about 7 minutes to show for a visitor who already Immich keeps the one copy and adds it to the share. The visitor's list shows the file as a duplicate. +### Can I approve uploads before visitors see them + +Not in Immich itself, but a workflow that moves each upload to your locked folder gives you the same result. See +[Review uploads before they appear](#review-uploads-before-they-appear). + ### Can visitors see who uploaded what, or remove photos No. The upload page shows nothing from the share, only the visitor's own uploads in progress, and nothing can be