Update docs

This commit is contained in:
Alan Grainger
2026-10-07 18:13:02 +13:00
parent 285d48e9d0
commit 6e65eff9f3
+37 -1
View File
@@ -1,7 +1,8 @@
# Let visitors send photos back # 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 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. 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) - [Set a storage quota](#set-a-storage-quota)
- [Request size limits](#request-size-limits) - [Request size limits](#request-size-limits)
- [Tag uploaded photos](#tag-uploaded-photos) - [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) - [Get a notification for each upload](#get-a-notification-for-each-upload)
- [Questions](#questions) - [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_`. 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)**. 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 ## Get a notification for each upload
Set [`upload.notifyUrl`](/config/upload-service#notifyurl) to a URL that receives a JSON message for each stored 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. 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 ### 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 No. The upload page shows nothing from the share, only the visitor's own uploads in progress, and nothing can be