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

# Group planner

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

The planned tasks and schedules of one group. It is [Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md) and [Manage planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md) limited to that group; only what changes is described here.

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

The picture shows a group's "Planned Tasks" tab with one schedule card on the left and its planned tasks on the right.

* **Where:** web: the "Planned Tasks" tab of a group's task list ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md)). The tab switches the view in place, so the address stays as it was. The address `/group/:id/planner` should open this tab directly, but once the group's "Tasks" tab was used last it opens "Tasks" instead. No link in the web app opens that address. iOS: the group's "Group view" menu > "Planned Tasks". Android: the group's "Group view" sheet > "Planned Tasks", which opens the planner as its own screen. Both apps leave the entry out for rooms and areas; iOS also leaves it out for asset registers.
* **Who:** every member who can open the group sees the planner. Creating a planned task needs both "Create New Task" and "Create Planned Tasks" in the group, or group admin. Opening, pausing and editing need less on the web; see [Actions](#actions).
* **Feature:** [Planned tasks](https://docs.snapfix.com/product/features/planner/planned-tasks.md)

## Layout

**Web**, the group's task list page:

1. The header, with the back button and the group menu (group image and name).
2. The tabs "Tasks" and "Planned Tasks". On the "Planned Tasks" tab the task list's own controls (filter, create, chat, the group menu's options) are hidden.
3. The planner, the same component as [Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md) with the group fixed: "Plan" and "Manage your Planned Tasks.", the filter button, "Search Planned Tasks", "Add Task" and the "Actions" menu; then the calendar and "Manage Planned Tasks" on the left and "Planned Tasks" on the right.
   * The info texts are the group versions: "Manage all your planned tasks for this group." and "View all your planned tasks for this group".
   * The filter drawer has no "Groups" filter, and both lists ask only for this group.

**iOS**, the "Planned Tasks" page of the group:

* The group's picture, name and address at the top. Tapping them opens the group's information ([Group purpose](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-purpose.md)).
* The [Plan](https://docs.snapfix.com/how-the-apps-work/screens/planner/plan.md) pager scoped to the group: the planned tasks page and the schedules page. The chips "Asset Registers" and "Comply" are hidden. "Housekeeping" is hidden too, except for account admins on a site with housekeeping, where it shows again.
* The app's top bar and the trial banner are hidden.
* The week and month switch, search, filter and the list, as on [Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md).
* A floating "+" and a settings icon that opens the schedules ([Manage planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md)). Both are hidden, and so is the empty state's second line, when the user lacks either create permission or is inactive in the group.

**Android**, a screen of its own:

* A top bar with the group's image, name and address (tapping it opens [Group purpose](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-purpose.md)), a search icon, a filter icon, and a "+" for users who may create planned tasks.
* Below it the planned tasks or the schedules, swapped in one place by the "Planned Tasks" chip. The chips "Asset registers", "Comply" and "Housekeeping" are hidden.
* A bottom bar with "List", "Grid", "Analytics" and "Planner" (selected). Its "Settings" item never shows, because the screen that opens the planner always passes the flag that would show it as off \[[ASK-52](https://github.com/snapfix/docs/blob/main/ASK.md#ask-52-should-the-android-group-planner-show-settings)].

## Inputs

The same fields as [Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md#inputs), with these differences:

| Field            | Type  | Required | Default    | Rules and messages                                                                                         |
| ---------------- | ----- | -------- | ---------- | ---------------------------------------------------------------------------------------------------------- |
| Group            | fixed | yes      | this group | There is no group picker. Web and iOS drop the "Groups" filter; every platform sends only this group's ID. |
| Search (Android) | text  | no       | empty      | The top bar's search field filters the planned tasks already loaded, on each change.                       |

## Actions

| Action                                                                    | Who                                                                                                                      | What happens                                                                                                                                                                                                                                    | API                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Open the planner                                                          | any member                                                                                                               | Web: loads the group, then both lists for this group. iOS and Android: open the planned tasks for this group.                                                                                                                                   | Web: [`POST /v4/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v4jobs) and [`POST /schedules-v2`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-schedules-v2). iOS and Android: [`POST /v3/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v3jobs) and [`POST /schedules`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-schedules) |
| "Add Task" (web), "+" (iOS, Android)                                      | both create permissions, or group admin; on iOS and Android the user must also be active in the group                    | Opens [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md) with this group chosen (web `/plan/planned-task/create/group/:id`).                                                                     | -                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| "Actions" > "Select Planners" (web)                                       | same as "Add Task"                                                                                                       | Turns on multi-select of the schedules ([Manage planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md#dialogs-and-sheets)).                                                                         | [`POST /schedules/pause`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-schedulespause)                                                                                                                                                                                                                                                                                                                       |
| Click a planned task (web)                                                | "Create Planned Tasks" or group admin                                                                                    | Opens the planned task for that date (`/plan/planned-task/edit/:id/:date`). Others see the permission alert ([Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md#dialogs-and-sheets)).                  | [`GET /v1/app/businesses/{uuid}`](https://docs.snapfix.com/engineering-reference/api/groups.md) to check the group                                                                                                                                                                                                                                                                                                                 |
| Tap a planned task (iOS)                                                  | anyone for a task already created; a future one needs both create permissions or admin                                   | A created task opens [Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md). A future one opens [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md) in edit mode. | -                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Tap a planned task (Android)                                              | not read-only, and both create permissions or admin                                                                      | A created task opens its task chat. A future one opens [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md) in edit mode.                                                                          | -                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Pause, resume, settings of a schedule                                     | as on [Manage planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md#actions) | On the web, the switch and the "⋯" button show only to users with both create permissions; the switch then checks "Create Planned Tasks" or admin again.                                                                                        | [`PUT /schedule/{uuid}/pause`](https://docs.snapfix.com/engineering-reference/api/planner.md#put-scheduleuuidpause), [`PUT /schedule/{uuid}/play`](https://docs.snapfix.com/engineering-reference/api/planner.md#put-scheduleuuidplay)                                                                                                                                                                                             |
| "Planned Tasks" chip (iOS, Android), settings icon (iOS)                  | anyone who sees it                                                                                                       | Switches between the planned tasks and the schedules of this group.                                                                                                                                                                             | -                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| "Tasks" tab (web); view menu (iOS); "List", "Grid", "Analytics" (Android) | anyone                                                                                                                   | Leaves the planner for that view of the group. Android closes the planner and returns that choice to the group's task list.                                                                                                                     | -                                                                                                                                                                                                                                                                                                                                                                                                                                  |

## States

* **Loading:** web: a spinner until the group is known, then the planner's own skeletons. iOS and Android: the list's spinner.
* **Empty:** the texts of [Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md#states) and [Manage planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md#states). On the web, the empty schedule list's "+" opens the create page (`/plan/planned-task/create/group/{id}`), even for users without the create permissions, who have no "Add Task". The create page lists only groups where the user may create, so this group is not offered; with no such group at all it shows "You are not an admin of any group, so you cannot create planned tasks." Live, that message also showed for a group created moments before, until the page was reloaded Android hides the empty state's "Create Planned Tasks" button without permission.
* **Error:** as on the site screens.
* **No permission:** both lists still load. Web: no "Add Task" and no "Actions" menu, and no switch or "⋯" on the schedule cards; opening a planned task shows the permission alert. iOS: no "+" and no settings icon. Android: no "+".
* **Offline (mobile):** as on [Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md#states). iOS lists the tasks on the device, including tasks that are not planned.

## Dialogs and sheets

* **No permission to open a planned task (web, Android, iOS):** "You don't have the right permissions to create or edit planned tasks in this group. Reach out to the group admin to review your permissions."
* **Read-only member (iOS, Android):** "You are read only user for this group that's why you can't open planned task. Reach out to the group admin to review your permissions."
* **Info (iOS, Android):** "View all Planned Tasks for this group, by week or by month." and "You can also choose the grey settings icon to Manage your Schedules."

## Platform differences

| Topic                  | Web                                                                | iOS                                                                   | Android                                                           |
| ---------------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------- | ----------------------------------------------------------------- |
| Where it lives         | a tab of the group's task list                                     | a page of the group's task pager                                      | its own screen                                                    |
| Schedules              | always beside the calendar, with bulk pause                        | a second page, through the chip or the settings icon                  | a second view, through the chip                                   |
| Leaving                | the "Tasks" tab or back                                            | the view menu or back                                                 | the bottom bar or back                                            |
| Opening a planned task | "Create Planned Tasks" or admin, always to the planned task editor | created task: no check, opens the task; future task: both permissions | both permissions for every task; created task opens the task chat |

The permission to open a planned task, and what opens, differ by platform \[[ASK-53](https://github.com/snapfix/docs/blob/main/ASK.md#ask-53-should-a-planned-task-open-the-planner-editor-or-the-created-task)].


---

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