> 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/product/features/tasks/task-lists.md).

# Task lists

{% 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)). [Source on GitHub](https://github.com/snapfix/docs/blob/main/product/features/task-lists.md).
{% endhint %}

People find and follow **tasks** in lists. **Fix** holds the **feed**, one list of the tasks from every **group** the user belongs to on the **site**, and each group has its own task list, one **status** at a time, as a grid, a list or (on the web) three status columns. Lists can be searched and sorted, and **SnapFilters** narrow them by status, priority, dates, people, tags, rooms, areas, assets and more. Bold titles and dots show what changed since the user last looked. Rooms and areas have task lists too, described with [Rooms and areas](https://docs.snapfix.com/product/features/rooms/rooms-and-areas.md).

## Rules

### Which tasks show

* Lists show only tasks the user may open ([Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md#who-can-open-and-change-a-task)): members without "View All Tasks" see the tasks they created, are assigned to or follow, and group admins see all ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md), [task permissions](https://docs.snapfix.com/engineering-reference/api/tasks.md#task-permissions)).
* The web gets this from the API. The apps apply it on the phone to the data they download, and the download itself sends every task of the group ([`POST /v5/{user_uuid}/jobs`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v5user_uuidjobs)).
* Multi-site users of the site see every task in a group's, room's or area's list ([task permissions](https://docs.snapfix.com/engineering-reference/api/tasks.md#task-permissions)).
* The feed lists the tasks of the site's active task groups the user belongs to. The apps leave out tasks whose creation time is in the future ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md)).
* With a multi-site selected, the web feed covers all of its sites and adds a "Sites" filter; the apps have no multi-site feed ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#filters)).
* Archived tasks show only with "Archived tasks", and frozen tasks only on the web \[[ASK-7](https://github.com/snapfix/docs/blob/main/ASK.md#ask-7-should-soft-freeze-still-run)] ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#filters), [`POST /v1/app/tasks/soft-freeze`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptaskssoft-freeze)).

### Statuses, views and counts

* A group's list shows one status at a time: red, amber or green, red first. The web remembers the last status per group ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#inputs)).
* Each status shows its count, "12", or "3 / 12" when filters narrow it, and the number of tasks with new updates. The feed tab shows "Feed (120)" or "Feed (12 / 120)" ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#layout), [Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#layout)).
* The web shows a group as a grid (default), a list or three status columns; the apps as a list or a grid, remembered per group ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#inputs)).
* In the web's status columns, dragging a card to another column changes its status, with the same checks as on the task ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#actions), [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md#status-and-priority)).
* Lists load in pages: the web fills the window (at least 20 tasks on the feed, 30 in a group), iOS loads 300 feed tasks or 100 per status, Android 50 ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#platform-differences), [Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#platform-differences)).
* Each row shows the image (the photo, the large text, or the room for housekeeping tasks), status, priority, lock, title, group, room and tags, due date or "Overdue", and "Pending Approval" or the last update time ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#layout)).

### Search and sort

* The web searches on the server, one second after typing stops. The feed matches the title, large text, group name and reference number; a group's list matches the status, reference number, title, description, chat messages and linked assets' attribute values ([task list filters](https://docs.snapfix.com/engineering-reference/api/tasks.md#task-list-filters)).
* The apps search the tasks on the phone: on the feed the title, reference number, large text and group name, plus the site name on Android; in a group also the description and chat messages ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#inputs), [Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#inputs)).
* A feed search for text that is part of the site's name shows every task in the apps, and on iOS a search with an apostrophe shows none.
* The feed sorts by "Latest update" or "Start Date". The web starts on "Start Date" until filters are cleared; the apps start on latest update ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#sort)).
* A group's list has eight sort orders, from "Priority" to "Alphabetical (Z-A)", starting on latest update ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#inputs)).
* A group's time frame ("Week", "Month", "All Tasks", and "Last 24 hours" in the apps) keeps tasks by their last activity in the apps, but by creation date on the web unless the list is sorted by latest update.

### Filters

* SnapFilters: "Priority", "Assigned to me", "Unread", "Overdue", "Due today", "Active tasks" or "Archived tasks", and "Approval tasks only"; the feed adds the three statuses and "Cleaning Tasks" and "Inspection Tasks" ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#filters), [Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#filters)).
* Advanced filters: people ("Created by", "Assigned to", and "Updated by" or "Followed by" on some lists), date ranges ("Created date", "Activity date", "Due date"), tags, rooms and areas; a group's list adds assets, and the web adds "Only includes tasks with cost" ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#filters)).
* "Active tasks" and "Archived tasks" exclude each other, and one of them is always on ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#filters)).
* "Overdue", "Due today" and a due date range combine with "or". "Due today" means later today; earlier today counts as overdue ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#filters), [task list filters](https://docs.snapfix.com/engineering-reference/api/tasks.md#task-list-filters)).
* "Approval tasks only" and its activity button belong to [Task approval](https://docs.snapfix.com/product/features/tasks/task-approval.md#rules).
* The feed starts the web on "New Tasks", "Tasks In Progress", "Active tasks" and "Assigned to me", and the apps on all statuses and "Active tasks" ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#inputs)).
* The feed's filters are saved per site, on the server and on the device, and come back on the next visit; on a web multi-site only on the device ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#inputs)).
* The web remembers a group's filters, search, status, sort, view and tab on the device ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#inputs)).
* The web's filter banner shows a chip per filter, but none for "Updated by" and "Sites" ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#dialogs-and-sheets)).

### New activity

* A task someone else changed since the user last opened its group shows a darker (web: bold) title and a dot; a task with activity since the user last opened it shows the darker title ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#layout), [`POST /v1/app/tasks/get-updates`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksget-updates)).
* Opening a group or a task records the visit, which these flags compare with. The log keeps a new row for every visit ([common side effects](https://docs.snapfix.com/engineering-reference/api/tasks.md#common-side-effects)).
* "Unread" filters on the same flags. The apps ask the server first, so offline it finds nothing new, and on room and area lists the web's request fails ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#states)).
* "Mark All as Read" in the web's group menu marks every task of the group as read, through a `GET` request ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#actions)). On area lists it fails.

### From a list

* Tapping a task opens [Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md); on the web "Previous" and "Next" then walk through the same list.
* "+" or "Create" starts a new task ([Creating tasks](https://docs.snapfix.com/product/features/tasks/task-creation.md)), and selecting several tasks starts [Multi-select](https://docs.snapfix.com/product/features/tasks/multi-select.md).
* A group's menu also holds "Share Multi Task Report (PDF)" ([Task reports](https://docs.snapfix.com/product/features/reports/task-reports.md)), "Duplicate Group" ([Groups](https://docs.snapfix.com/product/features/groups/groups.md)), the group's QR codes ([QR forms](https://docs.snapfix.com/product/features/qr/qr-forms.md)) and its chat ([Chat](https://docs.snapfix.com/product/features/chat/chat.md)).

## Flow

```mermaid
flowchart TD
  fix["Fix"] --> tab{"Tab"}
  tab -- Feed --> feed["Feed: tasks of my groups"]
  tab -- Groups --> groups["Groups"] --> group["Group tasks"]
  tab -- "Room Tasks, Areas" --> rooms["Rooms and areas"]
  group --> status["Red, amber or green"]
  feed --> refine["Search, sort, SnapFilters"]
  status --> refine
  refine --> list["Tasks I may see"]
  list --> open["Open a task"]
  list -- "long press or Select Tasks" --> multi["Multi-select"]
  list -- "Approval tasks only" --> approval["Task approval"]
  list -- "+ or Create" --> create["Creating tasks"]
```

## Platforms

| Capability                      | Web                                               | iOS                                    | Android                          |
| ------------------------------- | ------------------------------------------------- | -------------------------------------- | -------------------------------- |
| Feed                            | yes, from the server                              | yes, from the phone, 300 per page      | yes, from the phone, 50 per page |
| Multi-site feed                 | yes, with a "Sites" filter                        | no                                     | no                               |
| Group views                     | grid, list, status columns                        | list, grid                             | list, grid                       |
| Drag a task to another status   | yes, in status columns                            | no                                     | no                               |
| Group page size                 | fills the window, at least 30                     | 100 per status                         | 50 per status                    |
| Time frame                      | "Week", "Month", "All Tasks", by creation date    | adds "Last 24 hours", by last activity | same as iOS                      |
| People filters in a group       | "Created by", "Assigned to"                       | adds "Updated by"                      | adds "Followed by"               |
| "Only includes tasks with cost" | yes                                               | no                                     | no                               |
| Filters remembered              | feed per site on the server; groups on the device | feed per site; view per group          | same as iOS                      |
| Pull to refresh                 | no                                                | yes                                    | yes                              |
| Works offline                   | no                                                | yes                                    | yes                              |

## Screens

* [Fix](https://docs.snapfix.com/how-the-apps-work/screens/tasks/fix.md)
* [Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md)
* [Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md)
* [Room tasks](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room-tasks.md) and [Areas](https://docs.snapfix.com/how-the-apps-work/screens/rooms/areas.md), which use the group task list

## API and data

* Web lists: [`POST /v1/app/tasks/list`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptaskslist) for a group, room or area; [`POST /v1/app/tasks/list-by-parent`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptaskslist-by-parent) for the feed, which also saves its filters; [`POST /v1/app/tasks/list-by-multiSite`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptaskslist-by-multisite) for a multi-site; the filters in [task list filters](https://docs.snapfix.com/engineering-reference/api/tasks.md#task-list-filters).
* New activity: [`POST /v1/app/tasks/get-updates`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksget-updates) (web), [`POST ?action=read_jobs_read_status`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionread_jobs_read_status) (apps); [`GET /v1/app/tasks/mark-as-read/{type}/{itemUuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#get-v1apptasksmark-as-readtypeitemuuid); visits through [`?action=save_pri_log_businessvieweduser`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_log_businessvieweduser) (iOS) and `GET /v1/app/businesses/mark-as-visited/{businessUuid}` ([Groups API](https://docs.snapfix.com/engineering-reference/api/groups.md)).
* Apps' data: the sync loads in [`?action=read_data_v2`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionread_data_v2) and [`?action=read_data_v3`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionread_data_v3), and iOS downloads a group with [`POST /v5/{user_uuid}/jobs`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v5user_uuidjobs); counts come from `?action=group_taskcount` ([Groups API](https://docs.snapfix.com/engineering-reference/api/groups.md)).
* Feed filter preference: `GET` and `PUT /v1/app/user/preferences` ([Account API](https://docs.snapfix.com/engineering-reference/api/account.md)).
* Tables: [`tPri_Job`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_job.md), [`tPri_Log_JobViewedUser`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_log_jobvieweduser.md), [`tPri_Log_BusinessViewedUser`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_log_businessvieweduser.md), [`tPri_UserBusiness`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_userbusiness.md) (who sees what).

## Depends on

* [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md): who may open a task, and the status rules a drag between columns follows.
* [Groups](https://docs.snapfix.com/product/features/groups/groups.md) and [Group members](https://docs.snapfix.com/product/features/groups/group-members.md): the groups listed and "View All Tasks".
* [Switching sites](https://docs.snapfix.com/product/features/groups/site-switching.md) and [Multi-Site Console](https://docs.snapfix.com/product/features/console/multi-site-console.md): the feed covers the selected site or multi-site.
* [Task approval](https://docs.snapfix.com/product/features/tasks/task-approval.md), [Multi-select](https://docs.snapfix.com/product/features/tasks/multi-select.md) and [Creating tasks](https://docs.snapfix.com/product/features/tasks/task-creation.md): started from the lists.
* [Rooms and areas](https://docs.snapfix.com/product/features/rooms/rooms-and-areas.md) and [Cleaning tasks](https://docs.snapfix.com/product/features/housekeeping/cleaning-tasks.md): room and area lists, and the housekeeping filters of the feed.
* [Push notifications](https://docs.snapfix.com/product/features/notifications/push-notifications.md): pushes and live updates refresh rows in the apps.

## Edge cases

* **Offline (apps):** the lists, search and filters work from the phone; read flags and server counts don't load, so "Unread" finds nothing new ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#states)). The web needs a connection.
* **Empty lists:** "Manage your Tasks in a Snap!" with a hint to use "+". On a web group list that "+" does nothing, and shows even to users who can't create tasks ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#states)).
* **Filters hide everything:** the empty list looks the same as a list without tasks ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#states)).
* **Archived and frozen tasks:** archived tasks need "Archived tasks". Frozen tasks are left out of the apps' downloads; Android ends a group's last page with "Snapfix keeps your older tasks safe and secure…" \[[ASK-7](https://github.com/snapfix/docs/blob/main/ASK.md#ask-7-should-soft-freeze-still-run)] ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#layout)).
* **Deleted tasks:** they leave every list; the apps remove them when the sync or a live update reports the deletion ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#actions)).
* **Several sites:** the feed and groups follow the selected site. On a web multi-site the feed spans its sites, but its "Audit Trail" fails. iOS shows the larger of the phone's and the server's count until every task is downloaded ([Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#actions)).
* **Time zones:** date filters are whole days in the device's time zone; without one the server uses UTC ([task list filters](https://docs.snapfix.com/engineering-reference/api/tasks.md#task-list-filters)). The apps leave out tasks with a future creation time from a wrong phone clock.
* **Inactive members:** they see the list but can't create tasks or select several ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.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 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/product/features/tasks/task-lists.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.
