Help centerโ€บUploadingโ€บHow guest uploads work
๐Ÿ“คUploading

How guest uploads work

What happens when a guest scans the QR code and uploads a photo or video: from the tap through to the gallery feed.

Updated Apr 22, 2026

Here's exactly what happens when a wedding guest scans your QR code and shares a moment.

The guest side

  1. Scan, they open their phone camera, point at the QR, tap the notification that appears
  2. Land, a mobile-friendly page opens showing the couple's name, date, and a short hero image (usually the cover photo you set, or the first upload in the gallery)
  3. Tap, they tap + Share a moment at the bottom of the page
  4. Pick, their phone's photo picker opens, they choose one or more files
  5. Upload, files go directly from their phone to our storage. Progress shows per-file.
  6. Done, they see their contribution in the feed, can add a name if they want, and can keep browsing

No app download. No account sign-up. No email capture. Scan โ†’ tap โ†’ upload.

Behind the scenes

Photos: the original file is stored at full resolution. We also generate a web-friendly 1080px preview for fast feed loading. On free-tier events, the preview has a small Capture Club watermark. On paid tiers it doesn't.

Videos: the original is stored at full quality, then handed to our video service which makes it playable on every device. This takes anywhere from 30 seconds to a few minutes depending on file size. During that window, the video tile shows a "processing" indicator. Then it becomes playable with autoplay, mute toggle, and download button (on paid tiers).

Large files: up to 5 GB per file. Most iPhone photos are 5-12 MB. A 10-minute 4K video is ~4 GB. Uploads happen directly from the guest's phone to our storage, never through our servers, this is why even 5 GB videos work on decent Wi-Fi.

What guests see after uploading

  • Their upload shows up instantly in the feed
  • Everyone else on the same guest URL sees it too, live
  • If Review mode is on, their upload goes into a pending queue only visible to the host, they'll see a "thanks, your moment is being reviewed" message
  • They can heart, download, and share other guests' uploads
  • They stay anonymous unless they typed a name (name is optional, stored in their browser so they only type it once)

What happens if the upload fails

Capture Club automatically retries failed files up to 3 times with increasing delays. On the 3rd failure it marks the file as failed and lets the guest try again manually.

Common causes:

  • Weak Wi-Fi: switch to cellular or move closer to the router
  • iCloud still downloading the photo: iOS sometimes hasn't finished pulling an older photo from iCloud yet; see the upload-stuck troubleshooter
  • File too big (>5 GB), rare for photos, possible for long 4K videos
  • Photo is live photo with glitched audio: very rare, affects <0.1% of iPhone live photos

If retries keep failing on a specific file, tell the guest to skip it and keep uploading other files. One bad file doesn't stop the rest.

Guest name handling

When a guest types their name in the sticky bar at the top, it's saved in their browser's local storage under a per-event key. Next time they return to the same event URL, the name pre-fills. Different events on the same phone get different name prompts, no cross-contamination.

Names are not required. Anonymous uploads still work fine. The only reason to ask for a name is so your downloaded zip files include guest attribution in the filename ("001_lena-abc123.jpg").

Privacy note

Guest uploads go to the host's gallery, not a public feed. The guest URL is a long random slug, so people can't guess it or stumble onto another wedding's gallery. But anyone with the URL can view and upload, it's a capability token, not auth.

If you're hosting something where you want stricter access control, set a password on Pro tier via Pro Settings โ†’ Viewing room password. Guests still need the link, but also have to enter the password before they see anything.

Was this helpful?

Related articles

Review mode: approving guest uploads before they go live

Turn on Review mode and every guest upload sits in a pending queue until you approve or reject it. Guests do not know the difference. Useful for kid-heavy weddings, clients who want approval control, or when you need one evening of insurance.

iPhone uploads are slow: the iCloud Optimize Storage fix

If you are trying to upload 20 or more photos from an iPhone and the progress bar is crawling, you are waiting on iCloud to download full-resolution versions of your own photos. Here is why it happens and how to work around it.

What files can guests upload: formats and size limits

Capture Club accepts common photo formats (JPG, PNG, WebP, HEIC) and common video formats (MP4, MOV, WebM, M4V). The per-file cap is 200MB. Free events have an additional 50-upload cap. Details and workarounds here.

Still need a hand?

Contact support โ†’