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

# Multi-select

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

**Multi-select** lets people pick several **tasks** in a **group**'s task list and change them in one go: their **status** or **priority**, archive, lock or delete them, move them to another group, or add a checklist. The apps also add tags, assign users, set reminders, copy tasks to another group and mark them as read. It saves opening tasks one by one, for example to close a batch of finished jobs or tidy a group.

## Rules

### Starting and selecting

* Multi-select works on a group's task list only, not on the feed or a room's or an area's list ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#rooms-and-areas), [Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md#platform-differences)).
* The web starts it with "..." > "Select Tasks"; the apps with a long press on a task ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#multi-select)).
* In the apps a selection holds tasks of the open status, and "Select All" selects that status's tasks in the list. In the web's status columns a selection can mix statuses ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#multi-select)).
* The web's "Select All" offers "Select Loaded Tasks" and "Select ALL Tasks". "Select ALL Tasks" covers every task of the status that matches the list's filters, loaded or not, and isn't offered in the status columns ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#multi-select)).
* Members whose status in the group is inactive can't select. In the archived view, the apps don't start a selection for users without the delete permission ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#multi-select)).
* Buttons stay disabled until a task is selected, and the bar shows "n Task(s) Selected" (web) or "3 tasks selected" (apps).

### Actions

* Each action needs the same permission as on a single task ([Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md#who-can-open-and-change-a-task)); the actions a user may not use are hidden. The full list per platform is in [Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#multi-select).
* Status: the user needs the permission for the new status. On the web all selected tasks must share a status: "Selection contains tasks with different statuses. Please select tasks with the same status to proceed." ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#multi-select)).
* Green follows the approval rules: a group admin's green approves, anyone else's sends the tasks for approval ([Task approval](https://docs.snapfix.com/product/features/tasks/task-approval.md#sending-for-approval)).
* For the web, the server skips archived and locked tasks and tasks outside their time range (housekeeping tasks excepted), and keeps green from tasks with unfinished checklists when the group requires complete checklists ([`POST /v1/app/tasks/all/status`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksallstatus)).
* Priority: "Set priority for 3 task(s)" (high or medium) or "Remove priority for 3 task(s)". On the web, "Ok" before a choice removes the priority, and a new priority for "Select ALL Tasks" skips tasks that already have one.
* Tags, users, reminders, copying and marking as read are in the apps only ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#multi-select)).
* A reminder for several tasks also assigns the user to every selected task that has no assignee \[[ASK-18](https://github.com/snapfix/docs/blob/main/ASK.md#ask-18-should-setting-a-reminder-on-several-tasks-assign-the-caller)] ([`POST /job-reminders`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-job-reminders)).
* Copy (apps) and move are for group admins; the web also requires "Create New Task" for move. The target group must let the user create tasks, and the note "(Note: you must be an Admin in both Groups)" isn't checked ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#dialogs-and-sheets)).
* Bulk copies and moves follow the single-task rules, including the "Users" and "Tag folders" switches \[[ASK-21](https://github.com/snapfix/docs/blob/main/ASK.md#ask-21-who-may-copy-or-move-a-task-and-what-should-the-tag-options-do)] ([Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md#duplicate-copy-and-move)). They run in the background after the server answers, so the user isn't told when one fails ([`POST /v1/app/tasks/multi/move`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultimove), [`?action=copy_job_v2_multiselect`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actioncopy_job_v2_multiselect)).
* Archive needs the archive permission (iOS checks delete); archiving a cleaning task also archives its inspection task ([`POST /v1/app/tasks/multi/archive`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultiarchive)).
* On the web, lock changes only the tasks the user created or whose group they administer ([`POST /v1/app/tasks/multi/lock`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultilock)).
* Delete needs the delete permission; deleting a cleaning task also deletes its inspection task ([`POST /v1/app/tasks/multi/delete`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultidelete)).
* Tasks can't be unarchived in bulk. In the archived view the web offers only "Delete", also to users who may not delete, and the apps offer nothing.
* "Add Checklist" needs the site's checklist setting ("Manage checklists"). When some selected tasks already have a checklist, the web asks to replace it first ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#dialogs-and-sheets), [Checklists](https://docs.snapfix.com/product/features/checklists/checklists.md)).
* When every selected task is locked, the web stops archive, priority, status and lock: "The selected task is locked" or "All selected tasks are locked" ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#multi-select)).

### Confirmation and result

* The web confirms archive, lock and delete ("You're about to archive 3 task(s). Do you want to proceed?"), and the apps confirm through their own sheets, Android also before a status change ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#dialogs-and-sheets)).
* After a web action the selection closes, the list reloads and a message confirms it, such as "You've archived 3 task(s)". The web's status and priority dialogs would also confirm a failed reply.
* The apps save status, priority, tag, user, archive, lock and delete changes on the phone and sync them later; copy, move and reminders need a connection ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#states)).

### Server checks

* Bulk delete, archive and priority don't check that the listed tasks belong to the group, and bulk priority checks no permission, so they can change tasks in other groups by ID.
* Bulk actions change one task at a time, without a limit on how many.

## Flow

```mermaid
flowchart TD
  list["Group tasks, one status"] --> start{"Start selecting"}
  start -- "web: ... > Select Tasks" --> select["Pick tasks or Select All"]
  start -- "apps: long press" --> select
  select --> action{"Action"}
  action -- "Status, Priority" --> confirm["Confirm"]
  action -- "Archive, Lock, Delete" --> confirm
  action -- "Tag, User, Reminder (apps)" --> values["Pick values"]
  action -- "Copy or Move" --> target["Choose a group"]
  confirm --> apply["Applied to each allowed task"]
  values --> apply
  target --> background["Runs in the background"]
  apply --> reload["Selection closes, list reloads"]
```

## Platforms

| Capability       | Web                                       | iOS                                                                                                                                   | Android                                                                                                                               |
| ---------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Start            | "..." > "Select Tasks"                    | long press                                                                                                                            | long press                                                                                                                            |
| Select all       | loaded tasks, or all matching the filters | the status's tasks in the list                                                                                                        | same as iOS                                                                                                                           |
| Status, priority | yes                                       | yes                                                                                                                                   | yes                                                                                                                                   |
| Tags, users      | no                                        | yes                                                                                                                                   | yes                                                                                                                                   |
| Reminder         | no                                        | yes \[[ASK-18](https://github.com/snapfix/docs/blob/main/ASK.md#ask-18-should-setting-a-reminder-on-several-tasks-assign-the-caller)] | yes \[[ASK-18](https://github.com/snapfix/docs/blob/main/ASK.md#ask-18-should-setting-a-reminder-on-several-tasks-assign-the-caller)] |
| Add checklist    | yes, with the site setting                | yes                                                                                                                                   | yes                                                                                                                                   |
| Copy to a group  | no                                        | yes                                                                                                                                   | yes                                                                                                                                   |
| Move to a group  | yes                                       | yes                                                                                                                                   | yes                                                                                                                                   |
| Mark as read     | no                                        | yes                                                                                                                                   | yes                                                                                                                                   |
| Archive          | archive permission                        | delete permission                                                                                                                     | archive permission                                                                                                                    |
| Lock, delete     | yes                                       | yes                                                                                                                                   | yes                                                                                                                                   |
| Archived view    | "Delete" only                             | nothing                                                                                                                               | nothing                                                                                                                               |
| Works offline    | no                                        | yes, except copy, move and reminders                                                                                                  | same as iOS                                                                                                                           |

## Screens

* [Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md)
* [Copy or move task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/copy-move.md), whose confirmation the apps reuse

## API and data

* Web, selected tasks: [`POST /v1/app/tasks/multi/status`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultistatus), [`multi/priority`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultipriority), [`multi/archive`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultiarchive), [`multi/lock`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultilock), [`multi/delete`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultidelete) and [`multi/move`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultimove).
* Web, "Select ALL Tasks": [`POST /v1/app/tasks/all/status`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksallstatus), [`all/priority`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksallpriority), [`all/archive`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksallarchive), [`all/lock`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksalllock), [`all/delete`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksalldelete) and [`all/move`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksallmove), with the list's [filters](https://docs.snapfix.com/engineering-reference/api/tasks.md#task-list-filters).
* Apps: changes sync through [`?action=save_pri_job`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job), [`?action=save_job_status_log`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_job_status_log), [`?action=save_pri_job_userassigned`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_job_userassigned) and the tag action ([Tags API](https://docs.snapfix.com/engineering-reference/api/tags.md)); copy and move use [`?action=copy_job_v2_multiselect`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actioncopy_job_v2_multiselect) and [`?action=move_job_v2_multiselect`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionmove_job_v2_multiselect); reminders [`POST /job-reminders`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-job-reminders); mark as read [`?action=save_pri_log_jobvieweduser`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_log_jobvieweduser).
* Checklists: [Checklists API](https://docs.snapfix.com/engineering-reference/api/checklists.md).
* Tables: [`tPri_Job`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_job.md), [`tPri_Job_StatusLog`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_job_statuslog.md), [`tPri_JobChat`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_jobchat.md), [`tPri_JobTag`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_jobtag.md), [`tPri_JobUserAssigned`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_jobuserassigned.md), [`schedule_v3`](https://docs.snapfix.com/engineering-reference/db/tables/schedule_v3.md) (reminders).

## Depends on

* [Task lists](https://docs.snapfix.com/product/features/tasks/task-lists.md): the group list and its filters, which "Select ALL Tasks" reuses.
* [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md): the permissions and rules of each change, and copy and move.
* [Task approval](https://docs.snapfix.com/product/features/tasks/task-approval.md): green on tasks that need approval.
* [Reminders](https://docs.snapfix.com/product/features/notifications/reminders.md) and [Checklists](https://docs.snapfix.com/product/features/checklists/checklists.md): reminders and checklists added in bulk.
* [Push notifications](https://docs.snapfix.com/product/features/notifications/push-notifications.md): the web's bulk actions send one silent refresh to the group, and only when the server allows it \[[ASK-12](https://github.com/snapfix/docs/blob/main/ASK.md#ask-12-which-settings-do-the-production-api-servers-use)] ([`POST /v1/app/tasks/multi/status`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultistatus)).

## Edge cases

* **Offline (apps):** most changes queue on the phone; copy, move and reminders need a connection ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#states)).
* **Missing permission:** actions the user may not use are hidden; a status without its permission says "You don't have the necessary permissions" ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#dialogs-and-sheets)).
* **Mixed selections:** the server skips locked, archived and out-of-range tasks and answers with the number that changed ([`POST /v1/app/tasks/multi/archive`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultiarchive)).
* **"Select ALL Tasks":** it reaches tasks the user hasn't loaded or seen, as long as they match the filters.
* **Archived tasks:** they can't be unarchived in bulk.
* **Moves in the background:** a moved task gets a new ID in the target group, and the move isn't reported back when it fails ([`POST /v1/app/tasks/multi/move`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultimove)).
* **Several sites:** copies and moves stay within the site ([`POST /v1/app/tasks/multi/move`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksmultimove)); there is no multi-select across sites or on the multi-site feed.
* **Time zones:** a bulk reminder runs in the site's time zone, like a single one ([`POST /job-reminders`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-job-reminders)).


---

# 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/multi-select.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.
