> 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/task-activity.md).

# Task activity

{% 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/task-activity.md).
{% endhint %}

A task's details, tags and activity log, in three tabs.

* **Where:** iOS: task detail menu, "Task Activity" (under "Advanced Actions"). Android: task detail menu, "Task Activity", or the activity icon in the task detail toolbar. For an asset: "Asset Activity" in the asset detail menu ([Asset detail](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-detail.md)), with only the first two tabs.
* **Who:** anyone who can open the task, including users whose membership is inactive and tasks that are locked, archived or outside their time range. Nothing on the screen changes with the role.
* **Feature:** [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md)

## Layout

1. **Top bar:** back and the task title.
2. **Tabs:** "Activity", "Details" and "Tags" (assets: "Activity" and "Details"). The screen opens on "Activity"; swiping sideways also changes tabs.
3. **Tab content** (below).

**"Activity".** The task's activity, read from the data stored on the device, grouped by day under "Today", `Nov 10`, or `Nov 10,2025` on iOS and `Nov 10, 2025` on Android, oldest first, scrolled to the newest. The task's creation comes first, labelled with the group's name for the red status (assets: green). Each entry shows an icon, the user's photo and name, a line of text and the time: `Nov 10 2025 14:30` on iOS, `14:30:05` on Android. Android lays entries out like chat bubbles, the user's own on one side. Status changes show the group's name for the new status, and repeated changes to the same status show once. Messages show only "Text message added", "Image added", "Video added", "Attachment added", "Voice message added" or "Rejection note added", never their content. Other entries show their own text, for example tags, followers and assignees added or removed, checklist changes, reminders, due dates ("Due Date Set: ..." on Android), time and cost, time ranges (with "Start time" and "Duration"), rooms, areas, assets, compliance, copies and moves, approvals and snoozes. Deleted messages are left out. New entries appear while the screen is open.

**"Details".** From top to bottom:

* "Title :", the task title.
* "Task # :" and the reference number ("Asset # :" for assets). For one site, hard-coded in both apps, Android shows "PO Number :" instead; iOS sets that label and then overwrites it.
* "Group :" and the group name ("Asset Register :" for assets).
* "Created:" and "Last updated:", as `Nov 10 2025 14:30`.
* "Created by", "Assigned to" and "Followed by", each with photos (or initials) and names, or "--" when empty.
* "Last Viewed": the users who opened the task, each with the time they last did, or "---". Android shows the current user's time as now.
* "Time", when the task has time entries: one row per entry with its title, hours and minutes ("2 hrs 10 mins") and cost, then "Total:" per currency.
* "Cost" ("COST" on iOS), when the task has costs: one row per cost with its title and amount ("$ 12.00"), then "Total:" per currency.

**"Tags".** A "Find tag" box and the task's tags from the group's enabled tag folders, sorted by name. iOS orders the first three folders ahead of the rest. The list can't be changed here: each row has a remove button that both apps keep hidden.

## Inputs

| Field      | Type | Required | Default | Rules and messages                                                              |
| ---------- | ---- | -------- | ------- | ------------------------------------------------------------------------------- |
| "Find tag" | Text | No       | Empty   | Filters the tags by name as you type, ignoring case. Android has a clear button |

## Actions

| Action                | Who                          | What happens                                                                                                                                                                                                       | API                                                                                                                                  |
| --------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| Open the screen       | Anyone who can open the task | Loads the activity, details and tags from the device, and the "Last Viewed" list from the server. The server answers for any task and returns more about each viewer than the screen shows                         | [`POST ?action=read_jobs_last_viewed`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionread_jobs_last_viewed) |
| Change tab            | Anyone                       | Shows the tab; tap or swipe                                                                                                                                                                                        | -                                                                                                                                    |
| "View Chat" (Android) | Anyone                       | On an entry for a task someone else created from a chat message, opens that chat at the message ([Chat conversation](https://docs.snapfix.com/how-the-apps-work/screens/chat/conversation.md)). iOS hides the link | -                                                                                                                                    |
| Back                  | Anyone                       | Returns to the task or asset                                                                                                                                                                                       | -                                                                                                                                    |

## States

* **Loading:** everything except "Last Viewed" comes from the device and shows at once. Android shows a spinner under "Last Viewed" while it loads; iOS shows nothing until it arrives.
* **Empty:** "Tags" shows "No tags have been added" and "Tags are super helpful for quickly adding important information to Tasks. You can then ‘Filter’ using Tags to quickly find the Tasks, and generate Reports.", followed by where to add them ("Tags can be added from the + menu on the message screen, and also from the # icon on the first photo." on iOS). "Details" shows "--" for empty user lists and hides "Time" and "Cost" when there are none.
* **Error:** a failed "Last Viewed" request leaves that list empty. Android refreshes an expired session token and retries.
* **No permission:** none; the screen is read-only.
* **Offline (mobile):** works from the device. "Last Viewed" stays empty; Android doesn't call the server when offline.

## Platform differences

* **Activity layout:** iOS shows a list with the full date and time on each entry; Android shows chat-style bubbles with the time to the second.
* **"View Chat":** only Android offers it.
* **Last viewed:** only Android shows the current user's time as now.
* **Task number label:** only Android shows "PO Number :" for the one site that asked for it.
* **NFC (Android):** while the screen is open it catches NFC tag scans, so a scan here does nothing.


---

# 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/task-activity.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.
