Photo Slots

Define specific photos with instructions for structured photo collection.

Overview

Photo Slots allow you to create structured photo requests where each photo has specific instructions. Instead of asking for "photos of the car", you can define exactly what photos you need:

1. Front view
2. Rear view
3. Left side
4. Right side
5. Dashboard
6. Odometer

This ensures you receive consistent, complete documentation every time.

Use Cases

Photo Slots are ideal for:

• Vehicle inspections: Standard angles for car rentals, insurance claims
• Property documentation: Room-by-room photography
• Equipment audits: Specific components to photograph
• Quality control: Required checkpoints
• Delivery confirmation: Package, label, location photos

Creating Photo Slots

Photo Slots are configured in Step 2: Instructions when creating a One-time Request.

Adding Slots

1. Create a new Photo Request
2. Select One-time as request type
3. In the Instructions step, scroll to Photo Slots
4. Click Add Photo Slot for each required photo

Slot Configuration

Each slot has the following fields:

Field	Description
Photo Instruction	What to photograph (max 100 characters)
Required	Whether this photo is mandatory
Slot Type	Single photo (default) or Multiple photos
Max Photos	Maximum number of photos for multi-photo slots (2–20, default 20)

Instructions Examples

Write clear, specific instructions:

Good ✓	Bad ✗
"Front bumper - full view"	"Front"
"Dashboard with odometer visible"	"Inside"
"Damage close-up with ruler for scale"	"Damage"
"Package label showing tracking number"	"Label"

Required vs Optional

Setting	Behavior
Required	Submitter must upload this photo
Optional	Submitter can skip if not applicable

At Least One Required

Every request must have at least one required photo slot.

Multi-Photo Slots

By default, each slot accepts exactly one photo. Enabling Multiple Photos mode allows the photographer to take as many photos as needed for that slot before moving on.

Typical use case: Photographing a multi-page document where the number of pages is not known in advance — the photographer keeps shooting and taps "Done" when finished.

How it works for the submitter

After each photo is taken, the submitter sees:

• A counter showing how many photos have been taken (e.g., "3 photos taken")
• A primary Take another photo button
• A secondary I'm done button to close the slot and continue

When the configured maximum is reached, the slot closes automatically and advances to the next one.

Configuration

Setting	Description
Slot Type: Multiple Photos	Enable in the slot repeater in the dashboard
Max Photos	Set between 2 and 20 (default: 20)

Required multi-photo slots

If a multi-photo slot is marked as Required, the submitter must take at least one photo before tapping "Done".

No gallery or delete within the slot

Once a photo is taken inside a multi-photo slot, it cannot be deleted or reviewed before submission. The submitter can only continue shooting or finish the slot.

API configuration

Pass "type": "multi" for each slot that should accept multiple photos. Optionally set "max_photos" to limit the count:

{
  "items": [
    {
      "instructions": "Cover page",
      "is_required": true,
      "type": "single"
    },
    {
      "instructions": "All document pages",
      "is_required": true,
      "type": "multi",
      "max_photos": 15
    }
  ]
}

If "type" is omitted, the slot defaults to "single". If "max_photos" is omitted on a "multi" slot, the default is 20.

Organizing Slots

• Reorder: Drag and drop or use arrow buttons
• Collapse: Click to minimize slots for overview
• Delete: Remove slots you don't need

Plan Limits

Your plan determines the maximum number of slots:

Plan	Max Photo Slots
Free	5
Starter	10
Professional	25
Enterprise	50

Submitter Experience

When a customer opens a request with Photo Slots:

1. Instructions Screen: Sees your welcome message
2. Photo List: Views all required and optional photos
3. Sequential Upload: Takes/uploads each photo in order
4. Progress Indicator: Shows completed vs remaining
5. Skip Optional: Can skip non-required photos
6. Review: Previews all photos before submitting
7. Submit: Sends complete photo set

Visual Guidance

Each slot shows:

• Photo instruction text
• Required/optional badge
• Camera button to capture
• Preview thumbnail once captured
• Option to retake

Receiving Photos

When photos are submitted, they appear in your dashboard with:

• Original slot instruction as caption
• Order preserved from your configuration
• Required/optional status maintained
• Easy identification in gallery view

PDF Reports

Generated reports include:

• Each photo with its instruction
• Photos in configured order
• Required/optional indication
• Submitter notes (if any)

Best Practices

Plan Your Slots

Before creating, list all photos you need:

1. Consider your workflow requirements
2. Group related photos logically
3. Order from general to specific
4. Include optional slots for edge cases

Write Clear Instructions

• Be specific about angle and content
• Include any scale references needed
• Mention lighting requirements if critical
• Use industry-standard terminology

Use Optional Slots

Mark as optional when:

• Photo may not be applicable every time
• Condition-dependent (e.g., "Damage photo if present")
• Nice-to-have but not critical

Don't Over-Request

• More slots = more friction for submitter
• Balance completeness with convenience
• Consider separate requests for different purposes

Example Configurations

Vehicle Return (Car Rental)

Slot	Required
Front exterior full view	Yes
Rear exterior full view	Yes
Driver side full view	Yes
Passenger side full view	Yes
Dashboard with odometer	Yes
Fuel gauge	Yes
Any damage (if present)	No
Interior cleanliness	No

Delivery Confirmation

Slot	Required
Package with shipping label	Yes
Delivery location	Yes
Signature/proof of delivery	Yes
Package condition	No

Property Inspection

Slot	Required
Building exterior	Yes
Living room	Yes
Kitchen	Yes
Each bedroom	Yes
Bathrooms	Yes
Utility areas	No
Any issues found	No

Related Features

• One-time Requests - Create requests with slots
• PDF Reports - Export structured documentation
• Gallery - View submitted photos
• Tags - Organize by category