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

# Feed

{% 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: web, iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/tasks/feed.md).
{% endhint %}

One list of the tasks from all task groups of the site, with search, filters and sort.

* **Where:** web `/fix/feed`, the "Feed" tab of [Fix](https://docs.snapfix.com/how-the-apps-work/screens/tasks/fix.md); iOS and Android: bottom bar "FIX" > "Feed"
* **Who:** any signed-in member of the site. Web: the API decides which tasks come back. iOS and Android list the tasks of the site's active task groups that the user belongs to: every task in groups where the user is a group admin or has "View All Tasks" (`perJobViewAll`), and elsewhere only tasks the user created, is assigned to or follows. Tasks with a creation time in the future are left out.
* **Feature:** [Task lists](https://docs.snapfix.com/product/features/tasks/task-lists.md)

![Feed](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-edc716cf433f75ac34fd1886c558df1c288e6066%2Ffeed.png?alt=media)

## Layout

**Web**, top to bottom:

1. The Fix header and tabs ([Fix](https://docs.snapfix.com/how-the-apps-work/screens/tasks/fix.md)). The "Feed" tab shows the number of tasks, "(120)", or "(12 / 120)" when filters narrow the list.
2. Toolbar, on the right: the "Audit Trail" icon (only while "Approval tasks only" is on), the sort button (its icon shows the current sort), "Filter" (filled while filters differ from the defaults), the search box "Search Tasks", and "+".
3. Filter banner, while filters differ from the defaults: one chip per filter, such as "Active tasks", "3 task status color(s)" or "Approval tasks" (tags and assets get one chip each), then "Clear all".
4. The task list: one row per task. Enough rows to fill the window (at least 20) load first; more load when you scroll to the end.

**iOS and Android**, top to bottom:

1. The app's top bar, with the site switcher and "+" ([Home](https://docs.snapfix.com/how-the-apps-work/screens/tasks/home.md#top-bar)).
2. The Fix tabs ("Feed", "Groups", "Room Tasks", "Areas"), with "Feed (120)", or "Feed (12 / 120)" while filters are on; "Feed (-)" while counting. Next to them: search, approval activity (only while "Approval tasks only" is on) and filter buttons. Search opens a "Search tasks" field in place of the tabs.
3. The task list, with pull to refresh. iOS loads 300 tasks per page, Android 50; more load at the end of the list.

**Each row** shows:

* A thumbnail: the photo, the large text, or for cleaning and inspection tasks the room name. On it: the status (with an archive or frozen mark \[[ASK-7](https://github.com/snapfix/docs/blob/main/ASK.md#ask-7-should-soft-freeze-still-run)]), the priority, and a lock mark for locked tasks.
* The title. Unread or updated tasks show a darker (web: bold) title; tasks with new updates also show a dot.
* The group's image and name.
* Room occupancy and guest arrival icons, and the housekeeping task type, when they apply. On the web, occupancy is a person icon with the tooltip "Occupied", and arrival has "Arrival".
* The due date: "Overdue" when it passed and the task wasn't completed in time, otherwise the date ("MMM DD HH:mm", with the year when it isn't this year).
* The room and the first tags, then "+n".
* "Pending Approval" for tasks waiting for approval, otherwise the time of the last update (web "Nov 11, 2026 15:35").
* iOS and Android only: up to three assignees, then a count, or "Not Assigned"; the area.

## Inputs

| Field                                          | Type                         | Required | Default                                                                                                                                                                              | Rules and messages                                                                                                                                                                                                                                                                                                                                                  |
| ---------------------------------------------- | ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search ("Search Tasks"; mobile "Search tasks") | text                         | no       | empty; the web restores the last search                                                                                                                                              | Runs 1 s (web, iOS) or 0.3 s (Android) after typing stops. Web: the API matches. iOS and Android match the title, reference number, large text and group name; Android also the site name. When the text is part of the site's name, both apps show every task. On iOS a search containing an apostrophe shows no tasks, and no further pages load while searching. |
| Sort                                           | single choice                | yes      | web: "Start Date" on the first visit, and "Latest update (newest-oldest)" whenever the filters go back to the defaults; later visits restore the saved sort. Mobile: "Latest update" | See [Sort](#sort).                                                                                                                                                                                                                                                                                                                                                  |
| Filters                                        | drawer (web), sheet (mobile) | no       | web first visit: "New Tasks" and "Tasks In Progress", "Active tasks", "Assigned to me"; mobile: "Active tasks" and all statuses                                                      | See [Filters](#filters). Saved per site on the server and on the device, and restored on the next visit (web multi-site: on the device only).                                                                                                                                                                                                                       |

### Sort

| Option        | Web                             | iOS                                | Android         | Order                                                                                                                                                  |
| ------------- | ------------------------------- | ---------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Latest update | "Latest update (newest-oldest)" | "Latest update (newest to oldest)" | "Latest update" | Last activity, newest first                                                                                                                            |
| Start date    | "Start Date"                    | "start date"                       | "Start date"    | Web: the API's start date order. Mobile: tasks created or starting today first, then tasks without a start time, then by start time, then newest first |

On iOS, when the site uses housekeeping, high-priority tasks that aren't completed stay at the top in either order.

### Filters

![Filter panel](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-9ae5d5c8f0b13ef63609e1c88fff8e4322dc6349%2Ffeed-filters.png?alt=media)

| Section     | Filter                                                                         | Web             | iOS          | Android      |
| ----------- | ------------------------------------------------------------------------------ | --------------- | ------------ | ------------ |
| Status      | "New Tasks", "Tasks In Progress", "Completed Task" (mobile: "Completed tasks") | yes             | yes          | yes          |
| Sort        | see [Sort](#sort)                                                              | toolbar         | in the sheet | in the sheet |
| Snapfilters | "Priority" (high, medium; web: the stars "1" and "2")                          | yes             | yes          | yes          |
|             | "Assigned to me", "Unread", "Overdue", "Due today"                             | yes             | yes          | yes          |
|             | "Active tasks", "Archived tasks"                                               | yes             | yes          | yes          |
|             | "Approval tasks only"                                                          | yes             | yes          | yes          |
|             | "Cleaning Tasks", "Inspection Tasks"                                           | yes             | yes          | yes          |
| Advanced    | "People": "Created by", "Assigned to", "Updated by"                            | yes             | yes          | yes          |
|             | "Dates": "Created date", "Activity date", "Due date" (ranges)                  | yes             | yes          | yes          |
|             | "Tags" by tag folder (web "Tag folders"), "Rooms", "Areas"                     | yes             | yes          | yes          |
| Sites       | the sites of the multi-site                                                    | multi-site only | no           | no           |

* "Active tasks" and "Archived tasks" exclude each other: choosing one turns the other off, and one of them is always on.
* "Approval tasks only" shows completed tasks that wait for approval. Turning it on clears the other filters except "Active tasks" or "Archived tasks" (the web also keeps the status); choosing any other filter turns it off. While it's on, the "Audit Trail" or approval activity button appears.
* On iOS and Android, "Overdue", "Due today" and a due date range combine with "or": a task matching any of them shows. "Due today" means due later today; earlier today counts as overdue.
* With "Unread" on, the apps first ask the server which tasks are unread, then filter.

## Actions

| Action                     | Who                                       | What happens                                                                                                                                                                                                                                                                                                                                 | API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------------- | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Open a task                | anyone                                    | Opens [task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md). Web: `/group/:id/task/:taskId`.                                                                                                                                                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| "+" (web)                  | anyone                                    | Opens [Add a Task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/add-task.md), where the user also picks the group ([task creation](https://docs.snapfix.com/product/features/tasks/task-creation.md)).                                                                                                                           | [`POST /v1/app/tasks`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasks)                                                                                                                                                                                                                                                                                                                                                                                                                    |
| "+" (iOS and Android)      | anyone                                    | Opens the app's "+" menu ([Home](https://docs.snapfix.com/how-the-apps-work/screens/tasks/home.md#the--menu)).                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Create a task (mobile)     | members of a task group                   | Opens the [camera](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md); the last step picks the group ([add task to a group](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md)). "Create a new Voice Task" opens [voice task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/voice-task.md). |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Search, sort, filter       | anyone                                    | Reloads the list from the first page. The web saves the new filter on the server with the same request.                                                                                                                                                                                                                                      | Web: [`POST /v1/app/tasks/list-by-parent`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptaskslist-by-parent), multi-site [`POST /v1/app/tasks/list-by-multiSite`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptaskslist-by-multisite); filter preference: [`GET /v1/app/user/preferences`](https://docs.snapfix.com/engineering-reference/api/account.md), [`PUT /v1/app/user/preferences`](https://docs.snapfix.com/engineering-reference/api/account.md) (mobile) |
| Load read and update flags | automatic                                 | Web: after each page, marks rows as unread or updated. Mobile: asks for the read state of the listed tasks.                                                                                                                                                                                                                                  | Web: [`POST /v1/app/tasks/get-updates`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksget-updates); mobile: [`POST ?action=read_jobs_read_status`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionread_jobs_read_status)                                                                                                                                                                                                                                          |
| Count tasks (iOS)          | automatic                                 | Takes the larger of the local count and the server's count while the device hasn't downloaded every task.                                                                                                                                                                                                                                    | [`ANY ?action=webcust_list_parents_v2`](https://docs.snapfix.com/engineering-reference/api/console.md)                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Pull to refresh            | iOS, Android                              | Reloads from the device database and re-reads the saved filter.                                                                                                                                                                                                                                                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Approval activity          | anyone, while "Approval tasks only" is on | Opens [approval tasks activity](https://docs.snapfix.com/how-the-apps-work/screens/tasks/approval-activity.md) for the site.                                                                                                                                                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Fix tabs                   | anyone                                    | Switch to the other Fix tabs ([Fix](https://docs.snapfix.com/how-the-apps-work/screens/tasks/fix.md)).                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

The iOS and Android lists come from the device database, which the sync keeps up to date (see [shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md)). Both apps update a row when a push or sync message about that task arrives.

## States

* **Loading:** web: placeholder rows, and the Fix tabs are disabled; a spinner at the bottom while the next page loads. iOS and Android: the pull-to-refresh spinner, "Feed (-)" until counted, and a spinner at the bottom while the next page loads.
* **Empty:** web: the three status colors, "Manage your Tasks in a Snap!" and "To add a task, click on the + button."; the "+" opens [Add a Task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/add-task.md). The same text shows when filters or the search hide every task; nothing says that filters are on. iOS: "Manage your tasks in a Snap. Use the + icon to create a Task. Get things done!" Android: "Manage your Tasks in a Snap!" and "Use the + icon to create a Task. Get things done!"
* **Error:** web: the list stays as it was and the global error message shows; the tab count isn't updated. Mobile: the list shows what is on the device.
* **No permission:** the feed has no permission checks of its own; it lists only tasks the user may see.
* **Offline (mobile):** the list works from the device database. Read flags and server counts aren't loaded, so "Unread" finds nothing new.

![Empty feed with "Approval tasks only" on](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-805041ddfbc64ecbdd4b3bcbb28f72fac32a23b2%2Ffeed-empty.png?alt=media)

## Dialogs and sheets

* **Sort (web):** "Sort by", with the text 'The "Sort by" filter allows you to reorder tasks based on the desired criteria.', the two options, "Cancel" and "Apply". "Apply" reloads the list.
* **Sort (mobile):** opened from the filters sheet, with the two options (Android adds "Reorder tasks based on:").
* **Filter drawer (web):** titled "Filters", with tabs "Sites" (multi-site only), "Snapfilters" and "Advanced", and the buttons "Clear Filters" and "Apply". "Apply" stays disabled until a filter changes, and while no filter is set. The drawer closes with its "x" or Escape. See [Filters](#filters).
* **Filter banner (web):** a chip opens the drawer at that filter, and its "x" removes the value. Status and active or archived can't be removed, only changed; removing "Archived tasks" switches to "Active tasks" and the other way round. "Clear all" goes back to the defaults. "Updated by" and "Sites" filters get no chip.
* **Filters sheet (mobile):** titled "Filters", with "Status", the sort, "Snapfilters" and "Advanced" sections, and "Clear Filters" and "Apply". iOS opens date ranges in a calendar; Android in a date range picker.
* **Audit Trail (web):** the [approval tasks activity](https://docs.snapfix.com/how-the-apps-work/screens/tasks/approval-activity.md) dialog for the site, using the feed's filters and search. On a multi-site it fails.

## Platform differences

| Topic                     | Web                                                                 | iOS                            | Android                       |
| ------------------------- | ------------------------------------------------------------------- | ------------------------------ | ----------------------------- |
| Data                      | API, page by page                                                   | device database, 300 per page  | device database, 50 per page  |
| Defaults on first visit   | "New Tasks" and "Tasks In Progress", "Assigned to me", "Start Date" | all statuses, "Latest update"  | all statuses, "Latest update" |
| Search text after leaving | kept                                                                | cleared                        | cleared                       |
| Future tasks              | API decides                                                         | created up to the end of today | created up to now             |
| Multi-site                | one feed across the multi-site's sites, with a "Sites" filter       | not available                  | not available                 |
| Long press on a row       | nothing                                                             | nothing                        | 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/feed.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.
