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

# Planned 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/planner/planned-tasks.md).
{% endhint %}

The calendar of upcoming planned tasks: the occurrences that schedules create in their groups. The web shows the calendar, the schedules and the planned tasks on one page; the apps show a calendar above a list.

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

The picture shows the web planner of a site: the calendar and the schedule cards on the left, the planned tasks under date dividers on the right.

* **Where:** web `/plan/planner`, side menu "Plan"; `/plan` and any unknown `/plan/...` address redirect here. iOS and Android: [Plan](https://docs.snapfix.com/how-the-apps-work/screens/planner/plan.md) > "Planned Tasks". The same page scoped to one group is the [Group planner](https://docs.snapfix.com/how-the-apps-work/screens/planner/group-planner.md).
* **Who:** any signed-in user. The lists show the planned tasks of the groups the page sends; the server does not check that the caller belongs to them. Whether every member should see every group of the site is open \[[ASK-61](https://github.com/snapfix/docs/blob/main/ASK.md#ask-61-who-should-see-a-groups-planners-and-planned-tasks)].
* **Feature:** [Plan calendar](https://docs.snapfix.com/product/features/planner/plan-calendar.md)

The left column of the web page, and the "Scheduler" page on the apps, is [Manage planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md). Changing a planned task is [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md).

## Layout

**Web:**

1. The title "Plan" with "Manage your Planned Tasks." under it. On the right: the sites dropdown (multi-site only), the filter button, the search box "Search Planned Tasks", "Add Task", and the "Actions" menu ("⋯") with "Select Planners".
2. The left column, 475 px wide: the calendar, then [Manage planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md). The arrow above the calendar is "Hide calendar" or "Show calendar"; hidden, the calendar shows only the selected day ("Nov 12 2026").
3. The right column: "Planned Tasks" with an info icon ("View all your planned tasks for this site"), then the planned tasks as task cards in a grid, under a divider per day ("Nov 13", or "Nov 13 2027" outside the current year).

Each card is the [task card](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md) built from the planned task: the picture or large text, a red status, the priority, up to two assignees then "+N" (or "Not Assigned"), the title, the room and tags, the due date, the time and the group. Times show in the browser's time zone while the start is typed in site time, so they can differ from the form: a start of 9:00 typed for an India site shows as 11:30 in a browser at UTC+8.

**iOS** and **Android**, under the [Plan](https://docs.snapfix.com/how-the-apps-work/screens/planner/plan.md) chips:

1. A calendar, in week view first, with a week and month switch (iOS: two icons; Android: an icon). Android weeks start on Monday. Days with a loaded planned task get a dot.
2. "Planned Tasks" with an info icon, a search icon and a filter icon. iOS adds a settings icon that opens [Manage planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md).
3. The planned tasks under a date header per day, as task rows. Pull to refresh; the next page loads at the last row.
4. A "+" to create: iOS a floating button; Android the "+" in the app's top bar.

## Inputs

| Field            | Type                               | Required | Default                                                                   | Rules and messages                                                                                                                                                                                              |
| ---------------- | ---------------------------------- | -------- | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search (web)     | text                               | no       | empty                                                                     | "Search Planned Tasks", 1 s after typing stops. It reloads only [Manage planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md); the planned tasks are not searched. |
| Search (iOS)     | text                               | no       | empty                                                                     | "Search planned tasks". Filters the rows already loaded, on each change, by the task's search text.                                                                                                             |
| Search (Android) | text                               | no       | empty                                                                     | "Search tasks". Filters the rows already loaded, on each change, and stops paging while it has text. The empty view is set before the filter finishes, so a search that hides every row can leave a blank list. |
| Day              | calendar                           | no       | today                                                                     | Web: loads the planned tasks from the start of that day on. iOS and Android: scroll to that day when it is loaded; nothing is fetched.                                                                          |
| Filters          | drawer (web, Android), sheet (iOS) | no       | web: every group of the site, a filter that cannot be removed; apps: none | See [Filters](#filters).                                                                                                                                                                                        |

### Filters

| Filter                           | Web                                  | iOS                    | Android        | Effect                                                                                             |
| -------------------------------- | ------------------------------------ | ---------------------- | -------------- | -------------------------------------------------------------------------------------------------- |
| Priority                         | yes                                  | yes, "Snapfilters" tab | yes            | Sent with the request. On the web schedule list it is sent as an array, which the server fails on. |
| Assigned to me                   | yes                                  | yes, "Snapfilters" tab | yes            | Sent as the user on the assignee filter.                                                           |
| Created by                       | yes                                  | yes, "Advance" tab     | yes            | Sent. iOS offline compares the creator with the assignee list instead.                             |
| Assigned to                      | yes                                  | yes, "Advance" tab     | yes            | Sent. iOS offline does not apply it.                                                               |
| Groups                           | site page only; every group selected | site page only         | site page only | Sent.                                                                                              |
| Rooms, areas, tags, created date | offered                              | no                     | no             | Never sent, so they change nothing.                                                                |

* **Web drawer:** "Filters", with "SnapFilters" and "Advanced" tabs, "Clear Filters" and "Apply". Once the group list has loaded, "Groups" counts as a filter, so the filter button looks applied before the user picks anything.
* **iOS sheet:** "Snapfilters" and "Advance" tabs, "Apply" and "Clear All".
* **Android drawer:** "Snapfilters" and "Advanced" tabs, with the priorities "1" and "2", and searchable lists of groups, creators and assignees.

## Actions

| Action                                                             | Who                                                                                                | What happens                                                                                                                                                                                                                                                                             | API                                                                                                                                                                                                                                                                                                               |
| ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Open the page                                                      | anyone                                                                                             | Web loads the site's groups, then the schedules and the planned tasks from the start of today; a survey may show when the browser is idle. iOS and Android load forward from now.                                                                                                        | Web: [`POST /v4/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v4jobs). iOS and Android: [`POST /v3/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v3jobs)                                                                                                  |
| Pick a day (web)                                                   | anyone                                                                                             | Reloads the planned tasks from that day, keeping a selected schedule.                                                                                                                                                                                                                    | [`POST /v4/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v4jobs)                                                                                                                                                                                                                      |
| Scroll the list (web)                                              | anyone                                                                                             | Asks for 50 more: scrolling down loads later ones, scrolling up earlier ones, keeping the scroll position. Each end stops when a call returns nothing.                                                                                                                                   | [`POST /v4/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v4jobs)                                                                                                                                                                                                                      |
| Scroll the list (apps)                                             | anyone                                                                                             | Loads later ones at the last row. iOS never asks for earlier ones.                                                                                                                                                                                                                       | [`POST /v3/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v3jobs)                                                                                                                                                                                                                      |
| Click a planned task (web)                                         | "Create Planned Tasks" or group admin                                                              | Checks the group, then opens [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md) at `/plan/planned-task/edit/:scheduleId/:createdTs`. Otherwise the permission alert. A failed check shows "Something went wrong".                         | [`GET /v1/app/businesses/{uuid}`](https://docs.snapfix.com/engineering-reference/api/groups.md)                                                                                                                                                                                                                   |
| Tap a planned task (iOS)                                           | a created task: anyone; a future one: both create permissions or admin, and active in the group    | A task already on the device opens [Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md). A future one (created time still ahead) 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.                                                                                                                   | -                                                                                                                                                                                                                                                                                                                 |
| "Add Task" (web), "+" (apps), "Create Planned Tasks" (empty state) | site page: anyone, and the create page lists only permitted groups; group: both create permissions | Opens [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md) (web `/plan/planned-task/create`).                                                                                                                                               | -                                                                                                                                                                                                                                                                                                                 |
| Search, filter                                                     | anyone                                                                                             | As in [Inputs](#inputs). Web filters reload both lists.                                                                                                                                                                                                                                  | Web: [`POST /schedules-v2`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-schedules-v2) and [`POST /v4/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v4jobs). Apps: [`POST /v3/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v3jobs) |
| "Actions" > "Select Planners" (web)                                | users who see "Add Task"                                                                           | Turns the schedule list into multi-select ([Manage planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md#dialogs-and-sheets)).                                                                                                               | -                                                                                                                                                                                                                                                                                                                 |
| "Hide calendar" / "Show calendar" (web)                            | anyone                                                                                             | Folds or unfolds the calendar.                                                                                                                                                                                                                                                           | -                                                                                                                                                                                                                                                                                                                 |
| Week / month (apps)                                                | anyone                                                                                             | Switches the calendar.                                                                                                                                                                                                                                                                   | -                                                                                                                                                                                                                                                                                                                 |
| Pull to refresh (apps)                                             | anyone                                                                                             | Reloads from now; iOS reads the device copy when there is no connection.                                                                                                                                                                                                                 | [`POST /v3/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v3jobs)                                                                                                                                                                                                                      |
| Switch site                                                        | anyone with more than one site                                                                     | Web reloads the groups and both lists; the apps reload for the new site.                                                                                                                                                                                                                 | -                                                                                                                                                                                                                                                                                                                 |
| Info                                                               | anyone                                                                                             | Shows the info text ([Dialogs](#dialogs-and-sheets)).                                                                                                                                                                                                                                    | -                                                                                                                                                                                                                                                                                                                 |

The web calendar marks the days the server lists in `cal_highlight_dt`; the apps mark the days of the loaded rows.

## States

* **Loading:** web: ten skeleton cards, and a spinner at the edge while more load. iOS: "Refreshing...". Android: the refresh spinner, and a spinner at the bottom while the next page loads.
* **Empty:** web: "No data available". iOS: "Manage your Planned Tasks in a Snap!", "Start creating your planned tasks now." and "Create Planned Tasks". Android: "Manage your Planned Tasks in a Snap!", "Start creating your planned task now." and "Create Planned Tasks"; two more lines in the layout ("Here is where you will see all your planned tasks." and "To create your first 'Planned Task', tap the XXXX button.") stay hidden.
* **Error:** web: a failed load shows "No data available" with no message. iOS: a failed load shows the empty view, so it looks like there are no planned tasks; a tapped task missing from the device shows "Something went wrong". Android: a failed load keeps the list as it was; a tapped task missing from the device shows "Something went wrong. Please try again."
* **No permission:** the lists have no gate. Opening and creating follow [Actions](#actions).
* **Offline (mobile):** iOS does not call the server: it lists every task on the device that is not deleted or archived and was created before the end of today, including tasks that are not planned. Android shows "You must be connected to the Internet to carry out this task. Please connect and try again." and does not read the device. The web needs a connection.

Android sorts a page of planned tasks only when the page is empty, so rows stay in the order the server sent.

## Dialogs and sheets

* **Info:** web "View all your planned tasks for this site". iOS and Android: "View all Planned Tasks for this account, by week or by month." and "You can also switch to view the list of Schedules, displaying each original Planned Task." The group texts are on [Group planner](https://docs.snapfix.com/how-the-apps-work/screens/planner/group-planner.md#dialogs-and-sheets).
* **No permission:** "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." (web with an error icon; iOS and Android the same text).
* **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."
* **Filters:** see [Filters](#filters).

## Platform differences

| Topic                                                                                                                                                         | Web                                                                                                           | iOS                                                                                                        | Android                                                                                               |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| Shape                                                                                                                                                         | calendar and schedules left, planned tasks right                                                              | calendar above one list                                                                                    | calendar above one list                                                                               |
| Calendar                                                                                                                                                      | month grid that folds away                                                                                    | week, then month                                                                                           | week from Monday, then month                                                                          |
| List API                                                                                                                                                      | [`POST /v4/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v4jobs), both directions | [`POST /v3/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v3jobs), forward only | [`POST /v3/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v3jobs), forward |
| Search                                                                                                                                                        | the schedules, on the server                                                                                  | loaded rows                                                                                                | loaded rows                                                                                           |
| Opening a planned task \[[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)] | always the planned task editor                                                                                | created task: the task; future: the editor                                                                 | created task: the task chat; future: the editor                                                       |
| Offline                                                                                                                                                       | needs the network                                                                                             | device tasks, also unplanned                                                                               | connection message                                                                                    |

The web leaves a day's planned task out of the list once its task is created, while the apps keep created tasks with their colour.


---

# 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/planned-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.
