Bulk Uploading Photos

Bulk upload lets a team admin create headshot models for multiple team members in a single session. Instead of sending each member through the individual onboarding flow, you upload one ZIP file per person and submit them all from a single interface. Each submitted ZIP consumes one organization credit and kicks off generation automatically.

Bulk upload bypasses automatic photo quality checks. You are responsible for ensuring photos meet quality standards before uploading. Poor-quality source photos will produce poor results.

Prerequisites

Before you can use bulk upload, two conditions must be met:

• Your organization must have the bulk upload feature enabled. If you land on the admin dashboard instead of the bulk upload page, contact your account manager.
• Your organization must have credits available. Each submitted model deducts one credit.

You select 4 backdrops, 1 male outfit, and 1 female outfit before uploading. These selections apply to every model created in that session.

How it works

1. Go to Admin > Bulk Upload in your team dashboard.
2. Select 4 backdrops, a male outfit, and a female outfit from the pickers at the top of the page. The upload area only unlocks after all selections are made.
3. Prepare your ZIP files. Each ZIP must contain photos for a single person — one ZIP equals one model. Supported image formats inside the ZIP: JPG, JPEG, PNG, HEIC, HEIF, AVIF. Name each ZIP file after the person (e.g., jane-smith.zip) — the filename becomes the default model title.
   • Include 1–3 photos per ZIP.
4. Drag your ZIP files onto the upload area, or click to open a file picker. You can upload up to 20 ZIP files at once. Uploading more than 20 at a time is not supported — run a second batch if needed.
5. The system extracts each ZIP, detects faces, crops each photo automatically, and uploads the processed images. A dual progress bar shows overall batch progress and per-file image progress. Files with no valid faces or unreadable images are skipped with a warning toast.
6. Once processing completes, a table appears listing every successfully processed file. For each row:
   • Title — edit the model name. Defaults to the ZIP filename (without the .zip extension).
   • Gender — select Male or Female. This affects which outfit is used.
   • Photos — shows a thumbnail and photo count. Click the thumbnail or View all to open a photo preview modal where you can also remove individual photos.
7. Click Submit on each row to create the model. Submit button is disabled if the title is blank, gender is unset, or the photo count is out of range. Each submitted model immediately deducts one credit and triggers generation.
8. Completed rows display a green checkmark. Remaining rows can still be edited and submitted independently.

Good to know

• Processing happens locally before upload. Large batches with many high-resolution photos can take several minutes.
• HEIC and AVIF files are automatically converted to JPEG during processing. No pre-conversion needed.
• Mac ZIP files often contain a __MACOSX/ folder and .DS_Store files — these are automatically ignored.
• Images where no face is detected are silently skipped. If a ZIP ends up with zero processable photos, it is dropped from the list with an error message.
• Photos where the face covers less than 20% of the frame may be saved as full-body shots (up to 3 per ZIP). The rest are cropped to a headshot.
• The photo modal lets you remove individual photos from a processed ZIP before submitting. Removing photos counts against the minimum photo requirement — you cannot submit if the count drops below the minimum.
• Credits shown in the top-right of the uploaded files table update in real time as you submit models.
• There is no bulk-submit button. Each model is submitted individually, giving you a chance to review titles and gender before committing the credit.
• Models created via bulk upload are tagged so they can be identified separately from individually onboarded models.

Related

• Managing Members
• Getting Started as a Team Admin