> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/tasks/photo-edit.md).

# Photo edit and name

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/tasks/photo-edit.md).
{% endhint %}

Mark up the photo of a new task, or the first frame of its video, and give the task its name.

* **Where:** iOS and Android: [Camera](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md), after taking or picking a photo or video
* **Who:** anyone who reached the camera; what Send does next depends on where the camera was opened (see Actions)
* **Feature:** [Creating tasks](https://docs.snapfix.com/product/features/tasks/task-creation.md)

The same screen edits photos for task chat, checklists, planned tasks and asset photos; there the name field is hidden or becomes a caption. This doc covers new tasks.

## Layout

* **Photo:** the photo, or the video's first frame, fills the screen. A drawing layer lies on top, and a text layer of four lines when Text is on.
* **Top left:** back.
* **Tool column, right side, top to bottom:** undo (hidden on both platforms), crop, text, pen, circle, rectangle, arrow, eraser. The selected tool is highlighted.
* **Bottom bar:** the name field, "Task name" (in asset registers iOS "Asset Name", Android "Asset name"), with the AI badge "Snapfix Recommends" inside it when the name came from Snapfix AI, and the send button.

## Inputs

| Field             | Type                    | Required | Default                         | Rules and messages                                                                                                                                                                                                                                                                                                                                                                                   |
| ----------------- | ----------------------- | -------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name              | text                    | no       | empty, or the AI suggestion     | iOS stops at 255 characters and cuts longer pastes; Android has no limit. Left empty, the task takes the text written on the photo, or else the title "Task name" ("Asset Name" iOS, "Asset name" Android, in asset registers) in English whatever the app language. The database holds 255 characters ([`tPri_Job`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_job.md) `fTitle`) |
| Text on the photo | four single-line fields | no       | empty, placeholder "Enter Text" | Up to 13 characters per line; typing past the limit moves the last word to the next line and focus with it; deleting an empty line returns to the one above. Autocorrect is off. The text is drawn into the image                                                                                                                                                                                    |
| Markup            | drawing                 | no       | none                            | Pen, circle, rectangle, arrow and eraser; the eraser is selected when the screen opens, so nothing draws until another tool is picked                                                                                                                                                                                                                                                                |

## Actions

| Action                        | Who         | What happens                                                                                                                                                                                                                                                                          | API                                                                                                                                                                                           |
| ----------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Crop                          | anyone here | Opens a square (1:1) crop of the photo with its markup. After cropping, the markup is part of the photo and can no longer be erased, and the crop button disappears, so a photo can be cropped once. iOS crop buttons: "CROP" and "Cancel"; Android shows "Preparing for crop…" first | none                                                                                                                                                                                          |
| Text                          | anyone here | Shows the four text lines and the keyboard                                                                                                                                                                                                                                            | none                                                                                                                                                                                          |
| Pen, circle, rectangle, arrow | anyone here | Draws freehand, ellipses, rectangles or arrows on the photo                                                                                                                                                                                                                           | none                                                                                                                                                                                          |
| Eraser                        | anyone here | Erases drawn markup                                                                                                                                                                                                                                                                   | none                                                                                                                                                                                          |
| Back                          | anyone here | Returns to [Camera](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md); the photo is dropped                                                                                                                                                                         | none                                                                                                                                                                                          |
| Send                          | anyone here | Bakes markup and text into the task image and moves on (below). iOS ignores taps for one second after a tap; Android disables Send until it finishes                                                                                                                                  | none                                                                                                                                                                                          |
| AI name suggestion            | automatic   | See [AI name suggestion](#ai-name-suggestion)                                                                                                                                                                                                                                         | Android [`POST /v1/app/tasks/suggestions/title`](https://docs.snapfix.com/engineering-reference/api/ai.md); iOS the endpoint named `tasks-title-suggestion` in the endpoint list it downloads |

**After Send**

* **Started from Home** ("Snap", the "+" menu, the iOS quick action): opens [Add task to a group](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md). Nothing is saved yet, except on iOS: its "Created task" chat item is stored at this point, ready for upload, and stays behind when the user backs out of the group choice. The first task right after setup goes to [First task group](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/first-task.md) instead.
* **Started from a room or area:** iOS opens [Add task to a group](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md) as a sheet; on Android the room or area screen asks for the group ([Room tasks](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room-tasks.md)).
* **Started inside a group:** iOS checks the group itself: in an asset register it opens [Asset attributes](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-attributes.md); when the group requires tags, an assignee, an asset, a room or an area it opens [Tag your task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md#tag-your-task); when the group asks to confirm the location it opens [Set the task location](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md#set-the-task-location). Then it saves the task in that group and returns to the group's task list, which opens the new task. Android returns the photo and name to the group screen, which does the same ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md)).

**Image sizes:** iOS saves a JPEG whose longest side is at most 1600 pixels. Android saves a JPEG of at most 2048×2048 pixels, quality 85, up to 2 MB. When the user's app setting saves media to the phone gallery ([App settings](https://docs.snapfix.com/how-the-apps-work/screens/account/app-settings.md)), the image is also copied there, except for unchanged gallery photos.

**Task type:** the task records how it started in `enum_JobType`: 201 photo taken, 202 video recorded, 203 photo from the gallery, 204 video from the gallery ([`enum_JobType`](https://docs.snapfix.com/engineering-reference/db/tables/enum_jobtype.md)).

### AI name suggestion

When the site has AI suggestions on (`fAiSuggestionEnabled` in the site settings), for a photo (not a video) of a new task, outside asset registers, and while the name is empty:

1. When the screen opens, the app sends the photo to Snapfix AI, once.
2. If a title comes back and the name is still empty, the app fills it in and shows "Snapfix Recommends" (iOS "Snapflix Recommends"). Android first shows the suggestion, then replaces it with a translation into the app language when one arrives and the user has not typed.
3. Changing the name hides the badge; changing it back shows it again.
4. The task records whether its final name is the suggestion (`title_aiSuggested`), and the app logs suggestion and choice for AI reporting ([`?action=save_ai_job_log`](https://docs.snapfix.com/engineering-reference/api/ai.md)).

Failures are silent: the name stays empty.

## States

* **Loading:** none on screen; the AI suggestion runs in the background. Android shows "Preparing for crop…" before the crop screen.
* **Empty:** none.
* **Error:** AI failures are silent. On Android, when the final image cannot be compressed, Send stays disabled with no message.
* **No permission:** none needed here.
* **Offline (mobile):** everything works; the AI suggestion is skipped because its request fails.

## Dialogs and sheets

* **Crop:** a square crop over the photo. iOS: "CROP" and "Cancel" at the bottom, no rotation or aspect choice. Android: a crop screen with guidelines and a fixed 1:1 ratio. Cancelling keeps the photo as it was.

## Platform differences

* Android cuts landscape gallery photos to a square on [Camera](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md) before this screen; iOS leaves cropping to this screen.
* iOS limits the name to 255 characters; Android has no limit.
* iOS handles a group's required tags, assets and location on this screen when started inside a group; Android leaves that to the group screen.
* The badge reads "Snapflix Recommends" on iOS and "Snapfix Recommends" on Android; only Android translates the AI title.
* Image size: up to 1600 pixels on iOS, up to 2048 pixels on Android.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/how-the-apps-work/screens/tasks/photo-edit.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
