> For the complete documentation index, see [llms.txt](https://learn.withessential.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.withessential.com/administration/settings/require-photo-names-and-swipe-to-pass-fail-assets.md).

# Configure Technician App behavior

The Technician App page controls mobile behavior under **Schedule**, **Photo uploads**, **Inspection reports**, **Contacts**, **Job summary**, and **Documents**. Schedule sets how far back technicians can browse; Require photo names is the Photo uploads setting; other cards control swipe-to-pass inspection actions, technician contact management, Job Status defaults, the **Require visit notes** submission gate, Additional Questions, and documents shared with all or selected technicians.

> **Where to find it:** Settings -> Team -> Technician App

## Before you start

The page appears in Settings for anyone whose role has setup/admin access to a Settings area. If it's missing from your menu, ask an administrator to update your role or make the change for you.

## Days in the past technicians can see

Under **Schedule**, set how many days before today technicians can browse in the mobile app's Day, Week, and Month views:

* **0** (the default) - technicians see today onward only. This is the longstanding behavior, so nothing changes for existing businesses until you edit this setting.
* **A number of days** - technicians can go back that many days. For example, 14 lets a technician reopen any visit from the past two weeks.
* **No limit** - check **No limit — technicians can see the full history** to remove the restriction entirely.

Opening a past visit lets a technician work it like any other visit: review it, use On My Way and Clock In / Clock Out, and add or correct its visit summary. Resubmitting a summary updates the visit's existing Jobs task in place - it never creates a duplicate task. Clock times record the moment the technician taps (not the visit's original date), the automatic 24-hour clock-out still applies, and an On My Way tap notifies the customer the same way it does for a current visit. With the setting at 0, past visits stay read-only as before.

## Require photo names

Under **Photo uploads**, turn **Require photo names** on or off:

* **On** - a technician must enter a name before saving each job, property, or **asset** photo taken in the mobile app. Here **asset photo** is the screen's wording for a photo attached to an asset group, not an individual asset.
* **Off** - the photo's filename is filled in automatically, and the technician can still replace it.

The same rule applies to multi-photo uploads. With Require photo names on, every row in **Review photos** needs a name before the batch can be saved. With it off, Essential pre-fills each photo's original filename and lets the technician keep or replace it.

## Swipe to pass or fail assets

Under **Inspection reports**, turn **Swipe to pass or fail assets** on or off. This is opt-in and off by default. When it's on, technicians can swipe an asset right to pass it or left to fail it directly from an inspection report's asset list, without opening the asset first. Failing opens a form to log the deficiency (description, notes, photos). The gesture only works on asset lists whose report definition has Bulk Pass questions configured - the same setup that shows the bulk **Pass** button.

## Add and edit contacts

Under **Contacts**, turn **Add and edit contacts** on to let technicians manage the visit customer's contacts. This setting is off by default, so existing businesses keep the read-only visit-contact experience.

When it is on, a technician assigned to a visit can open **Contacts** there to:

* See every contact for the customer, including contacts that are not on the visit.
* Create a contact for the customer with customer-level roles or roles for the current property.
* Edit any customer contact's name, title, email, phone numbers, and roles at either scope.

A new contact needs at least one customer-level or current-property role before it can be saved. These changes update the shared customer contact record, so the office sees the same details and roles. They do not change which contacts are attached to the visit.

## Require visit notes

Under **Job summary**, turn **Require visit notes** on when technicians must enter **Visit Notes** before they can submit a job summary. This is a required-field gate, not a default value: Essential marks the field required and blocks submission until the technician enters a note.

## Save your changes

Changes do not apply until you select **Save**. If you navigate away with an unsaved change, Essential warns you first. Technicians may need to reopen the mobile app before a change takes effect.

## Related guides

* [Add and name photos in the mobile app](/field-operations/mobile/add-and-name-photos.md)
* [Swipe to pass or fail assets on mobile](/field-operations/mobile/swipe-to-pass-or-fail-assets.md)
* [Working with the assets on an inspection report (bulk pass, skip, delete)](/field-operations/inspection-reports/working-with-the-assets-on-an-inspection-report-bulk-pass-skip-delete.md)
* [Share documents with technicians](/administration/settings/share-documents-with-technicians.md)
* [What you can set up in Settings](/administration/settings/what-you-can-set-up-in-settings.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://learn.withessential.com/administration/settings/require-photo-names-and-swipe-to-pass-fail-assets.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
