> ## Documentation Index
> Fetch the complete documentation index at: https://docsv4.mile.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Photo

> Capture one or more photos from the camera or the gallery.

**Photo** lets the field worker take or upload pictures as part of the task. It is the usual way to attach visual proof: the parcel at the door, the site condition, damaged goods or a signed paper form.

**Use cases**

* **Proof of delivery**: the package at the drop-off point.
* **Pickup check**: the parcel and the pickup point.
* **Damage report**: damaged goods on arrival.
* **Site inspection**: the condition of a location.
* **Receipt or form**: a photo of a paper document.

## Properties

![Photo properties](https://mintcdn.com/mileappv4/Zv-R0yz4NrNyQHzp/images/v4/workflow/components/photo.png?fit=max\&auto=format\&n=Zv-R0yz4NrNyQHzp\&q=85\&s=f391fb1b204b28e21ff9e5c8a237c8e2)

1. **Visible**: when off, the component is hidden on the web and the field app; its photos are still kept and exported.
2. **Watermark**: stamp the time and the location coordinates onto every photo taken.
3. **Select from Gallery**: let the worker pick an existing photo from the phone's gallery instead of taking a new one.
4. **Minimum Count of Photos**: how many photos must be added. **0** makes the component optional; 1 or more makes it mandatory. It cannot be above the maximum.
5. **Maximum Count of Photos**: the most photos that can be added, at least 1.
6. **Photo Categories**: optional labels for the photos, such as *Front door*, *Package* or *Receiver*. Type a category and press Enter, or click **Add category**. Each photo is then filed under one of them.

> [!NOTE]
>
> Photo has no Required switch: a **Minimum Count of Photos** of 1 or more makes it required.

## How to set it up

**1. Add the component**

Click **Add component** and choose **Photo**. Write a **Title**, such as *Proof of Delivery*.

**2. Set the counts**

Set **Minimum Count of Photos** (0 for optional) and **Maximum Count of Photos**.

**3. Choose the capture options**

Turn on **Watermark** for verifiable proof. Turn on **Select from Gallery** to allow existing pictures.

**4. Add categories (optional)**

Add **Photo Categories** to sort the photos.

## On the field app

![Photo, signature, voice and subflow in the preview](https://mintcdn.com/mileappv4/Zv-R0yz4NrNyQHzp/images/v4/workflow/components/photo-signature-preview.png?fit=max\&auto=format\&n=Zv-R0yz4NrNyQHzp\&q=85\&s=ef8761d39c37a67f617a867b76f819af)

1. The photo block shows the title and a counter such as `0/3` (added / maximum).
2. Tapping it opens the camera, or the gallery when **Select from Gallery** is on.
3. Photos appear as thumbnails; tap one to view or delete it.
4. With **Watermark** on, the time and coordinates are printed on the saved photo.
5. The task cannot be finished until the **Minimum Count of Photos** is reached.

Photos of finished tasks also appear in the [Gallery](https://docsv4.mile.app/pages/activities/task/gallery.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.