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

# Group tasks

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

The tasks of one group, by status, as a grid, a list or three status columns, with search, filters, sort, multi-select and task creation.

* **Where:** web `/group/:id/tasks`, a group in [Groups](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-list.md), "Back" from a task, or the "Tasks" tab next to "Planned Tasks"; iOS and Android: Fix > "Groups" > a group, or a task notification. Group links don't open it on iOS. The same screen also lists a room's or an area's tasks: see [Rooms and areas](#rooms-and-areas).
* **Who:** members of the group; what each member can do depends on the group's permissions (table below). Web: if the group can't be loaded, the user goes back to Fix.
* **Feature:** [Task lists](https://docs.snapfix.com/product/features/tasks/task-lists.md), [Multi-select](https://docs.snapfix.com/product/features/tasks/multi-select.md)

| Who                                                | What changes                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Group admin (group role "Admin")                   | Every permission below, plus copying or moving tasks to another group; on mobile also "Duplicate Group", and on Android "Group QR".                                                                                                                                                                                                                                                                                                           |
| Members, by permission                             | Create tasks (`perJobCreateNew`): "+", and on the web "Chat". Change status (`perJobMoveToRed`, `perJobMoveToAmber`, `perJobMoveToGreen`), per status. Archive (`perJobArchive`; iOS checks delete instead). Delete (`perJobDelete`). Assign users (`perAssignUser`): bulk "User" on mobile. Reports (`perJobReportGenerate`): "Share Multi Task Report (PDF)" on mobile. Group settings (`perBusSettingsScreenAccess`): the settings button. |
| Members without "View All Tasks" (`perJobViewAll`) | iOS and Android show only tasks they created, are assigned to or follow. The web shows what the API returns.                                                                                                                                                                                                                                                                                                                                  |
| Inactive members (onboarding status "Inactive")    | Web: no group permissions. Mobile: no task creation, report, "Duplicate Group" or "Group QR" (Android), and no multi-select.                                                                                                                                                                                                                                                                                                                  |
| Multi-site users (web)                             | The "..." menu shows only to group admins.                                                                                                                                                                                                                                                                                                                                                                                                    |
| Sites with "Manage checklists" (`manageChecklist`) | Web: bulk "Add checklist".                                                                                                                                                                                                                                                                                                                                                                                                                    |

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

## Layout

**Web**, top to bottom:

1. Header: "Back" (to Fix), the group's image and name (opens [group purpose](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-purpose.md)), the site name when a multi-site is selected, and the settings button (with group settings access) to [group settings](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-settings.md).
2. Tabs "Tasks" and "Planned Tasks" ([group planner](https://docs.snapfix.com/how-the-apps-work/screens/planner/group-planner.md)). Next to them, on the "Tasks" tab: "Audit Trail" (only while "Approval tasks only" is on), "Chat" (when the site has chat and the user can create tasks), "Filter", the search box "Search", "Create" (the "+" button, with create permission), the QR button ([group QR codes](https://docs.snapfix.com/how-the-apps-work/screens/groups/qr-codes.md)) and "..." (the group menu).
3. Quick filters: sort, time frame, "Assigned to me" and priority; the status selector; the view switch (grid, list, status).
4. The filter banner, while filters go beyond "Active tasks".
5. The tasks: a grid of cards (default), a list, or three status columns. Enough tasks to fill the window (at least 30) load first; more load at the end.

While tasks are being selected, rows 2 and 3 are replaced by the selection bar ([Multi-select](#multi-select)).

**Status selector (web):** three circles, red, amber and green. Each shows the group's name for that status as a tooltip and the number of tasks below it: "12", or "3 / 12" when filters narrow it. The open status also shows how many loaded tasks have new updates (up to 99). The status view hides the selector.

**iOS**, top to bottom:

1. Top bar: back, the group's image, name and address with an info icon (a settings icon for users with group settings access); tapping them opens [group purpose](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-purpose.md). Then search and "+".
2. Toolbar: sort, time frame, "Group view" and filter; approval activity while "Approval tasks only" is on.
3. Status tabs: red, amber and green with their counts and update counts. Tapping a tab shows the group's name for that status.
4. A banner with the number of new tasks left in the site's plan, when it's nearly used up.
5. The open status's tasks, as a list or a grid, with pull to refresh; 100 tasks per page.
6. When scrolling back up, a bottom bar with "Grid", "List", "Dashboard" and "Calendar" appears. "Dashboard" opens the [legacy dashboard](https://docs.snapfix.com/how-the-apps-work/screens/reports/legacy-dashboard.md).

**Android**, top to bottom:

1. Toolbar: back, the group's image, name and subtitle, an online or offline indicator (with the number of changes waiting to sync), the settings button (group settings for admins and users with access, otherwise [group purpose](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-purpose.md)), Simon AI (when on) and "..." (the group menu).
2. Status tabs: red, amber and green with their counts and update counts. Tapping or swiping switches status.
3. A row with the view type ("Group view"), "Assigned to me", priority, search, approval activity (while "Approval tasks only" is on) and filter.
4. "n new tasks left in this account. Learn more" when the site's plan is nearly used up.
5. The open status's tasks, as a list or a grid, with pull to refresh; 50 tasks per page. The last page ends with a note about older tasks: "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)].
6. The app's bottom bar.

**Cards and rows** show the same facts as [feed rows](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#layout): thumbnail (photo, large text, or room name for cleaning and inspection tasks), status with archive or frozen mark \[[ASK-7](https://github.com/snapfix/docs/blob/main/ASK.md#ask-7-should-soft-freeze-still-run)], priority, lock, title (darker when unread or updated, with a dot for new updates), group, room and tags, due date, and "Pending Approval" or the last update time. They also show the assignees (up to three, then "+n") or "Not Assigned", and the occupancy and arrival icons. In the web status view, a task's room shows only when the task also has tags, and the due date is hidden while selecting.

**Status view (web):** three columns side by side, one per status. Each column header shows the status, its updates count, the group's name for the status and "12 Tasks" (or "1 Task", "3 / 12" with filters). Each column loads its own pages.

## Inputs

| Field                                    | Type                                          | Required | Default                                                                                                                                                                          | Rules and messages                                                                                                                                                                                                                                                                                                                             |
| ---------------------------------------- | --------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search ("Search"; mobile "Search tasks") | text                                          | no       | web: the last search on this group and tab; mobile: empty                                                                                                                        | Web: sent 1 s after typing stops; the API matches. iOS and Android match the title, description, large text, reference number and chat messages.                                                                                                                                                                                               |
| Status                                   | red, amber or green                           | yes      | red; web remembers the last one per group                                                                                                                                        | Web: the status selector; turning on "Approval tasks only" switches to green. Mobile: the status tabs.                                                                                                                                                                                                                                         |
| Sort                                     | single choice                                 | yes      | "Latest update (newest-oldest)" (mobile "Latest update (newest to oldest)")                                                                                                      | Options: "Priority", "Latest update (newest-oldest)", "Latest update (oldest-newest)", "Due date", "Create date (newest-oldest)", "Create date (oldest-newest)", "Alphabetical (A-Z)", "Alphabetical (Z-A)". Web: changing it turns "Approval tasks only" off.                                                                                 |
| Time frame                               | single choice                                 | yes      | all tasks                                                                                                                                                                        | Web "Display Tasks": "Week", "Month", "All Tasks". iOS and Android: "Last 24 hours", "Week", "Month", "All tasks". The web filters by the creation date unless the sort is by latest update, and changing the sort afterwards leaves the old range filtering while the control shows "All Tasks"; the apps always filter by the last activity. |
| "Assigned to me"                         | toggle                                        | no       | off                                                                                                                                                                              | Quick filter; also in the filters.                                                                                                                                                                                                                                                                                                             |
| Priority                                 | multiple choice                               | no       | none                                                                                                                                                                             | "Priority SnapFilter": "Show only tasks with priority:" high, medium.                                                                                                                                                                                                                                                                          |
| Filters                                  | drawer (web), sheet (mobile)                  | no       | "Active tasks"                                                                                                                                                                   | See [Filters](#filters).                                                                                                                                                                                                                                                                                                                       |
| View                                     | grid, list, status (web); list, grid (mobile) | yes      | web: grid; mobile: the last one used on the group (Android starts with the [grid or list](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/grid-or-list.md) choice) | Web: the view switch. iOS: "Group view" or the bottom bar. Android: "Group view".                                                                                                                                                                                                                                                              |

The web remembers the filters, search, status, sort, view and tab per group on the device. The apps remember the view per group.

### Filters

| Section             | Filter                                                         | Web     | iOS                           | Android            |
| ------------------- | -------------------------------------------------------------- | ------- | ----------------------------- | ------------------ |
| Snapfilters         | "Priority", "Assigned to me", "Unread", "Overdue", "Due today" | yes     | yes                           | yes                |
|                     | "Active tasks", "Archived tasks" (one of them is always on)    | yes     | yes                           | yes                |
|                     | "Approval tasks only"                                          | yes     | yes                           | yes                |
| Advanced            | "People": "Created by", "Assigned to"                          | yes     | yes                           | yes                |
|                     | "People": "Updated by"                                         | no      | yes                           | no                 |
|                     | "People": "Followed by"                                        | no      | no                            | yes                |
|                     | "Dates": "Created date", "Activity date", "Due date"           | yes     | yes                           | yes                |
|                     | "Tags", "Rooms", "Areas", "Assets"                             | yes     | yes                           | yes                |
|                     | "Only includes tasks with cost"                                | yes     | no                            | no                 |
| Sort and time frame | see [Inputs](#inputs)                                          | toolbar | toolbar and the filters sheet | the filters drawer |

"Approval tasks only" works as on the [feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#filters): it clears the other filters and shows completed tasks that wait for approval.

## Actions

| Action                                                             | Who                                                                                                                                                                            | What happens                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Load tasks                                                         | automatic                                                                                                                                                                      | Web: one page of the open status (each column in the status view), then the read and update flags. Mobile: from the device database.                                                                                                                                                                                                                                                                                                                                               | [`POST /v1/app/tasks/list`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptaskslist), [`POST /v1/app/tasks/get-updates`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksget-updates); group: [`GET /v1/app/businesses/{uuid}`](https://docs.snapfix.com/engineering-reference/api/groups.md); mobile read flags: [`POST ?action=read_jobs_read_status`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionread_jobs_read_status), counts: [`ANY ?action=group_taskcount`](https://docs.snapfix.com/engineering-reference/api/groups.md) |
| 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`).                                                                                                                                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Drag a card to another column (web status view)                    | users with the target status permission                                                                                                                                        | Changes the task's status. Refused with "Task is locked", "Task is archived", "You don't have the necessary permissions", or, when the group requires it, "All Checklist-items must be checked before you can move this Task to green. This condition was set by the Admin of this group." On a churned site the subscription dialog opens instead. The card moves back on any error.                                                                                              | [`PUT /v1/app/tasks/{uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#put-v1apptasksuuid)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| "Create" / "+" > create a task                                     | create permission                                                                                                                                                              | Web: [Add a Task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/add-task.md) for this group ([task creation](https://docs.snapfix.com/product/features/tasks/task-creation.md)). Mobile: the [camera](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md); voice opens [voice task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/voice-task.md). Android first checks the site's plan and shows the plan banner when no new tasks are left. | [`POST /v1/app/tasks`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasks) (web)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| "Chat" (web)                                                       | create permission, site chat on \[[ASK-48](https://github.com/snapfix/docs/blob/main/ASK.md#ask-48-should-every-member-be-able-to-open-a-task-groups-chat-from-the-task-list)] | Opens the group's chat ([chat conversation](https://docs.snapfix.com/how-the-apps-work/screens/chat/conversation.md)), creating it and the site chat first when they don't exist.                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| "Audit Trail" / 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 this group.                                                                                                                                                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| "Mark All as Read" (web "...")                                     | anyone who sees "..."                                                                                                                                                          | Marks all of the group's tasks as read.                                                                                                                                                                                                                                                                                                                                                                                                                                            | [`GET /v1/app/tasks/mark-as-read/{type}/{itemUuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#get-v1apptasksmark-as-readtypeitemuuid)                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| "Share Multi Task Report (PDF)"                                    | web: anyone who sees "..."; mobile: admins and users with the report permission                                                                                                | Web: creates the report for the whole group, checks every 6 seconds for up to 6 minutes, then downloads it. iOS: a report of the listed tasks; above 50 tasks it asks "This report will contain n tasks and could take several minutes to process. Do you want to process?"; needs a connection.                                                                                                                                                                                   | [Reports API](https://docs.snapfix.com/engineering-reference/api/reports.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| "Duplicate Group"                                                  | web: anyone who sees "..."; mobile: group admins                                                                                                                               | Asks for confirmation, then copies the group. Web: "Group duplicated successfully."                                                                                                                                                                                                                                                                                                                                                                                                | [Groups API](https://docs.snapfix.com/engineering-reference/api/groups.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| QR button (web), "Group QR" (mobile)                               | web and iOS: anyone; Android: group admins                                                                                                                                     | Opens [group QR codes](https://docs.snapfix.com/how-the-apps-work/screens/groups/qr-codes.md). Mobile needs a connection.                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| "Select Tasks" (web), long press (mobile)                          | see [Multi-select](#multi-select)                                                                                                                                              | Starts selecting tasks.                                                                                                                                                                                                                                                                                                                                                                                                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| "Planned Tasks" (web tab), "Group view" > "Planned Tasks" (mobile) | anyone                                                                                                                                                                         | Opens the [group planner](https://docs.snapfix.com/how-the-apps-work/screens/planner/group-planner.md).                                                                                                                                                                                                                                                                                                                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| "Group view" > "Analytics" (mobile)                                | anyone                                                                                                                                                                         | Opens [analytics](https://docs.snapfix.com/how-the-apps-work/screens/reports/analytics.md).                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Pull to refresh                                                    | iOS, Android                                                                                                                                                                   | Reloads the list and counts.                                                                                                                                                                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Log the visit                                                      | automatic                                                                                                                                                                      | Web: on leaving, when the list had updates, marks the group as visited. iOS: after loading the read flags, logs the visit for the sync.                                                                                                                                                                                                                                                                                                                                            | Web: [`GET /v1/app/businesses/mark-as-visited/{businessUuid}`](https://docs.snapfix.com/engineering-reference/api/groups.md); iOS: [`POST ?action=save_pri_log_businessvieweduser`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_log_businessvieweduser)                                                                                                                                                                                                                                                                                                                      |

### Multi-select

How to start: web "..." > "Select Tasks"; iOS and Android: long press a task in the open status. Not available to inactive members, nor in the archived view for users without the delete permission (mobile).

**Web selection bar:** "Select All" (a menu with "Select Loaded Tasks" and "Select ALL Tasks"; not in the status view), "n Task(s) Selected", "Actions", "Changes Priority", "Changes Status", and close. Clicking a card selects or unselects it. Buttons stay disabled until a task is selected. In the archived view the bar shows only "Delete", even to users without the delete permission, whom the server then refuses.

**iOS selection bar:** "Select All", "3 tasks selected", "Status" (with any status permission), "Priority", "Tag", "User" (with the assign permission) and "More". **Android:** "Select All" and "n tasks selected" at the top; "More", "User" (admins and users with the assign permission), "Tag", "Priority" and "Status" (admins and users with any status permission) at the bottom. In the archived view, iOS and Android show no actions at all.

| Action                 | Web                                                                    | iOS                                              | Android                                          | API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------------------- | ---------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Change status          | "Changes Status"; all selected tasks must have the same status         | status button                                    | "Status"                                         | Web: [`POST /v1/app/tasks/multi/status`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultistatus) or, after "Select ALL Tasks", [`POST /v1/app/tasks/all/status`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksallstatus); mobile: saved on the device and synced, [`POST ?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job), [`POST ?action=save_job_status_log`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_job_status_log) |
| Set or remove priority | "Changes Priority"                                                     | priority button                                  | "Priority"                                       | Web: [`POST /v1/app/tasks/multi/priority`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultipriority), [`POST /v1/app/tasks/all/priority`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksallpriority); mobile: synced, [`POST ?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job)                                                                                                                                                                                |
| Add tags               | no                                                                     | "Tag"                                            | "Tag"                                            | synced, [Tags API](https://docs.snapfix.com/engineering-reference/api/tags.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Assign users           | no                                                                     | "User"                                           | "User"                                           | synced, [`POST ?action=save_pri_job_userassigned`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job_userassigned)                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Set a reminder         | no                                                                     | "More" > "Set Reminder"                          | "More" > "Set Reminder"                          | [`POST /job-reminders`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-job-reminders)                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Add a checklist        | "Actions" > "Add Checklist" (site setting)                             | "More" > "Add Checklist"                         | "More" > "Add Checklist"                         | [Checklists API](https://docs.snapfix.com/engineering-reference/api/checklists.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Copy to another group  | no                                                                     | "More" > "Copy to group" (group admins)          | "More" > "Copy to Group" (group admins)          | [`POST ?action=copy_job_v2_multiselect`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actioncopy_job_v2_multiselect)                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Move to another group  | "Actions" > "Move Task to Group" (group admins with create permission) | "More" > "Move to group" (group admins)          | "More" > "Move to Group" (group admins)          | Web: [`POST /v1/app/tasks/multi/move`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultimove), [`POST /v1/app/tasks/all/move`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksallmove); mobile: [`POST ?action=move_job_v2_multiselect`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionmove_job_v2_multiselect)                                                                                                                                                                                  |
| Mark as read           | no                                                                     | "More" > "Mark all as read" (the selected tasks) | "More" > "Mark all as read" (the selected tasks) | [`POST ?action=save_pri_log_jobvieweduser`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_log_jobvieweduser)                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Archive                | "Actions" > "Archive" (archive permission)                             | "More" > "Archive" (delete permission)           | "More" > "Archive" (archive permission)          | Web: [`POST /v1/app/tasks/multi/archive`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultiarchive), [`POST /v1/app/tasks/all/archive`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksallarchive); mobile: synced                                                                                                                                                                                                                                                                                                        |
| Lock                   | "Actions" > "Lock"                                                     | "More" > "Lock"                                  | "More" > "Lock"                                  | Web: [`POST /v1/app/tasks/multi/lock`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultilock), [`POST /v1/app/tasks/all/lock`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksalllock); mobile: synced                                                                                                                                                                                                                                                                                                                    |
| Delete                 | "Actions" > "Delete" (delete permission)                               | "More" > "Delete" (delete permission)            | "More" > "Delete" (delete permission)            | Web: [`POST /v1/app/tasks/multi/delete`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultidelete), [`POST /v1/app/tasks/all/delete`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksalldelete); mobile: synced                                                                                                                                                                                                                                                                                                            |

* The web uses the `all` endpoints, with the list's filters, when "Select ALL Tasks" selected more tasks than are loaded; otherwise it sends the selected task IDs. The server checks these IDs against the group for status changes only.
* Web: when every selected task is locked, archive, priority, status and lock stop with "The selected task is locked" or "All selected tasks are locked". Mixed statuses stop "Changes Status" with "Selection contains tasks with different statuses. Please select tasks with the same status to proceed."
* Web: after a bulk action the selection closes and the list reloads; a message confirms it, for example "You've archived 3 task(s)".

## States

* **Loading:** web: placeholder cards, the controls are disabled, and a spinner at the bottom while the next page loads; the header shows a small spinner until the group loads. Mobile: the refresh spinner.
* **Empty:** web: the three status colors with the open one highlighted, "Manage your Tasks in a Snap!" and "To add a task, click on the + button."; the "+" in that text does nothing, and it shows even to users who can't create tasks. The same text shows when filters or the search hide every task. iOS and Android: "Manage your Tasks in a Snap!" and "To add a task, tap the + button."; tapping the "+" creates a task, and the line is hidden for users who can't create tasks.
* **Error:** web: if the group can't be loaded, the user goes back to Fix. If the list can't be loaded, the global error message shows and the empty state appears.
* **No permission:** controls the user may not use are hidden (see the table under Who). Status changes without the permission show "You don't have the necessary permissions" (web) or "You don't have the right permissions to change task status in this group. Reach out to the group admin to review your permissions." (Android).
* **Offline (mobile):** the list, filters and bulk changes work on the device and sync later. Read flags come from the device. Copy, move, reminders, reports and "Group QR" need a connection.

## Dialogs and sheets

* **Sort by:** web dialog "Sort by" with 'The "Sort by" filter allows you to reorder tasks based on the desired criteria.', the eight options, "Cancel" and "Apply". Mobile sheet with the same options (Android: "Sort by" / "Reorder tasks based on:").
* **Time frame:** web "Display Tasks", "See only the tasks updated in the last:", "Week", "Month", "All Tasks", "Cancel" and "Apply". Android "Time Frame" with "See only the tasks updated in the last:". iOS: a sheet with the four options.
* **Priority SnapFilter:** "Show only tasks with priority:" with high and medium. Web: "Click a priority icon to select or unselect it. The filters will update automatically."; Android: "Clear Filters" and "Apply".
* **Filters:** the web drawer and mobile sheets work as on the [feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#dialogs-and-sheets).
* **Group menu ("..." web):** "Snap it. Fix it.", "Share Multi Task Report (PDF)", "Duplicate Group", "Mark All as Read", "Select Tasks".
* **"+" (iOS) and "..." (Android):** "Create a new task" and "Create a new Voice Task" (create permission; Android "Create a New Voice Task"), "Create a new Group" (users allowed to create groups), "Share Multi Task Report (PDF)" (report permission), "Group QR" (iOS: everyone; Android: group admins), "Duplicate Group" (group admins) and "Chat with this Task-group", which opens the group's chat.
* **Group view (mobile):** "Group view", "Display your group tasks in list, grid,or analytics view." (Android), with "List view", "Grid view", "Analytics" and "Planned Tasks".
* **Change Status (web):** "You've selected 3 task(s) with a Red status. Would you like to change them?", the three statuses, "Cancel" and "Ok" ("Ok" stays disabled until another status is chosen); choosing a status without its permission shows "You don't have the necessary permissions". Android: "Change Status" with the same question, then "You're about to change the status of 3 tasks. Do you want to proceed?". When the request fails, the web shows its error dialog and the dialog stays open.
* **Priority (web):** "Set priority for 3 task(s)" (then high or medium) or "Remove priority for 3 task(s)", "Cancel" and "Ok". "Ok" is enabled before either choice is made and then removes the priority; it also confirms after a failed request. Android: "Priority", "set Priority", "Remove Priority", "Apply".
* **Move (web):** "Choose a group", "Choose the Group to move the Tasks into" and "(Note: you must be an Admin in both Groups)", the group list, "Cancel" and "Save". Choosing this group shows "Please select a different Group. Tasks cannot be moved to the same Group."; a group where the user can't create tasks shows "Access denied". Then "Confirm Move": "You're about to move 3 task(s) to Kitchen. Do you want to proceed?", with "Users" and "Tag folders" switches (copy them to the target group, on by default), "Cancel" and "Confirm". The move runs in the background.
* **Archive, Lock, Delete (web):** confirmations "You're about to archive 3 task(s). Do you want to proceed?", "…lock…", "…delete…".
* **Add checklist (web):** when some tasks already have one, "Replace Checklist" first; then the checklist picker ([checklists](https://docs.snapfix.com/how-the-apps-work/screens/checklists.md)). Without the site setting: "You do not have sufficient permissions to manage the checklist. Please contact your site administrator for access or additional details."
* **Set Reminder (Android):** "Date:", "Time:", "Repeat reminder daily", "Cancel" and "Ok".
* **Copy or move (mobile):** a group picker, then a confirmation ([copy or move task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/copy-move.md)).
* **Unsaved tasks (iOS):** going back while new tasks aren't synced yet shows "Warning: The following task has not been saved to the Snapfix cloud:" with their titles; its button then goes back.

## Rooms and areas

The web routes `/room/:id/tasks` and `/area/:id/tasks`, and the mobile room and area task lists ([room](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room.md), [area](https://docs.snapfix.com/how-the-apps-work/screens/rooms/area.md)), use this screen with these changes:

* The header shows the room or area. On mobile, tapping the header (iOS) or the info button (Android) opens the room or area info.
* No tabs and no multi-select; the web has no filter button. The web "..." menu has only "Mark All as Read" (site admins only on a multi-site); the mobile menu has "Create a new task", "Create a New Voice Task", "Share Multi Task Report (PDF)" and "Mark all as read".
* Anyone can create a task (web multi-site: site admins only); the new task gets the room or area. The web asks for its group in [Add a Task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/add-task.md).
* Cards show each task's group.
* Lists use [`POST /v1/app/tasks/list`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptaskslist) with the room or area, and "Mark All as Read" uses the `room` or `area` type.

## Platform differences

| Topic                             | Web                                                                           | iOS                                    | Android                                |
| --------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------- | -------------------------------------- |
| Views                             | grid, list, status columns with drag and drop                                 | list, grid                             | list, grid                             |
| Page size                         | fills the window, at least 30                                                 | 100 per status                         | 50 per status                          |
| Time frame                        | "Week", "Month", "All Tasks", by creation date unless sorted by latest update | adds "Last 24 hours", by last activity | adds "Last 24 hours", by last activity |
| Bulk tags, users, reminders, copy | no                                                                            | yes                                    | yes                                    |
| Report                            | whole group, by the server                                                    | the listed tasks                       | the listed tasks                       |
| "Duplicate Group"                 | anyone who sees "..."                                                         | group admins                           | group admins                           |
| Archive permission                | archive                                                                       | delete                                 | archive                                |
| Archived view, multi-select       | "Delete" only                                                                 | no actions                             | no actions                             |


---

# 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/group-tasks.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.
