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

# Reminders

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

A **reminder** brings a **task** back to people's attention with a push and a line in the task's chat. There are three kinds. A **personal reminder** ("Remind me") is set by one person for a date and a time, once or every day, on one task or, in the apps, on several at once. A **due-date reminder** goes to the task's assignees every day once a **due date** is set with "Repeat reminder daily". A **planned-task reminder** is meant to tell a **planner**'s assigned users the day before each **planned task**; today its push never shows. A scheduler on Snapfix's servers finds the reminders that are due and asks the push service to send them, so reminders go out without anyone opening the app.

## Rules

### Personal reminders

* A personal reminder has a start date, a time, and a repeat of once or daily ("Repeat reminder daily"). There is no other repeat ([Remind me](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#remind-me), [`POST /job-reminder/{job_uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-job-reminderjob_uuid)).
* On the web the dialog starts at tomorrow, 8:00 AM, and offers only today or later (web\_app\_v2 @ 0989b8e685, `src/app/pages/task/task-quick-actions/task-reminder-dialog/task-reminder-dialog.component.ts:185-199`).
* The time is the site's time, whatever the time zone of the person who sets it. A site with no time zone uses Europe/Dublin (apipy @ 0e83c85e5a, `model/schv3/feature_job_reminder.py:218-220`). The dialogs don't say so, and the web and iOS send the device's time zone, which the server ignores.
* A task has one personal reminder. Setting one replaces the earlier one, and "Cancel Reminder" ("Cancel reminder" on Android) removes it ([`POST /job-reminder/{job_uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-job-reminderjob_uuid), [`DELETE /job-reminder/{job_uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#delete-job-reminderjob_uuid)).
* Setting a reminder writes a chat line, "Task reminder set to repeat daily at …" or "Task reminder set to occur once at …"; cancelling writes "Task reminder cancelled" ([`POST /job-reminder/{job_uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-job-reminderjob_uuid)). On the web, setting or cancelling also sends the task's people a silent push, so their apps refresh (web\_app\_v2 @ 0989b8e685, `task-reminder-dialog.component.ts:138`, `:160`, `:244-258`; [Push delivery](https://docs.snapfix.com/engineering-reference/api/notifications.md#push-delivery)).
* The person who sets a reminder is assigned to the task on every platform, if they are not already; the web says so in the dialog ([Remind me](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#remind-me); web\_app\_v2 @ 0989b8e685, `task-reminder-dialog.component.ts:234-240`; ios @ aa31967ac8, `SnapFix/MessagesVC/MessagesVC.swift:4354-4358`; android @ 86068bfeea, `app/src/main/java/gmail/com/snapfixapp/fragment/JobChatFragment.java:6308-6311`).
* When it is due, every live assignee of the task gets a push titled with the task's title: "You have a reminder to get things done in {group}". It is visible only for people whose "When a Reminder is activated" switch is on, and it also adds a "Task reminder" line to the chat ([`POST /job/reminder-notification-v2`](https://docs.snapfix.com/engineering-reference/api/notifications.md#post-jobreminder-notification-v2), [Notification settings](https://docs.snapfix.com/how-the-apps-work/screens/notifications/settings.md#inputs)).
* A one-time reminder switches itself off after it fires. A daily reminder repeats every day until someone cancels it ([`POST /job/reminder-notification-v2`](https://docs.snapfix.com/engineering-reference/api/notifications.md#post-jobreminder-notification-v2)).
* A personal reminder keeps firing after the task is green or archived, until someone cancels it.
* On iOS and Android, "More" > "Set Reminder" in a group's task list sets one reminder on several tasks. Deleted and archived tasks are skipped, and the person is assigned to each 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)]. The web has no bulk reminder ([Multi-select](https://docs.snapfix.com/product/features/tasks/multi-select.md), [`POST /job-reminders`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-job-reminders)).
* On a housekeeping task, only people on today's housekeeping schedule may set a reminder; iOS saves it before it checks ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#inputs)).
* The apps need a connection to set or cancel a reminder ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#states)).
* The server lets any signed-in user set, read or cancel the reminder of any task.

### Due-date reminders

* "Repeat reminder daily" on a due date creates a daily reminder for the task's assignees. The first one comes the day after the due date is set, at the due date's time of day, in the site's time zone (api\_php\_live\_v2 @ ef3c4319f6, `app/Services/ScheduleService.php:158-177`).
* It goes on every day, also after the due date has passed, until the task is green, archived or deleted or the due date is removed. Before the due time the text is "{task} in {group} is due on {date}"; after it, "Overdue : {task}". Each one also writes a chat line ([`POST /job/due-reminder-notification`](https://docs.snapfix.com/engineering-reference/api/notifications.md#post-jobdue-reminder-notification)).
* Saving or removing a due date deletes its old daily reminder first (api\_php\_live\_v2 @ ef3c4319f6, `app/Traits/JobDueDate.php:264-266`).
* The push is visible whenever the person's "Task Notifications" is on, whatever the other switches say, unless the group is muted ([Push notifications](https://docs.snapfix.com/product/features/notifications/push-notifications.md#which-switches-apply)).
* The scheduler skips tasks that are green, archived, deleted or frozen, and reminders that are paused (py\_scheduler @ c8b1344036, `models/cron_schedule_v3.py:263-280`).
* Android ignores "Repeat reminder daily" the first time a due date is set.

### Planned-task reminders

* A planner with "Add 24 Hour Reminder" on reminds its assigned users who are still in the group, "{task} is scheduled for tomorrow". The timing, its errors and what pausing does are in [Planned tasks](https://docs.snapfix.com/product/features/planner/planned-tasks.md#reminder).
* The push goes out silent, so neither app shows it today ([`POST /v3/scheduler/reminder-notification`](https://docs.snapfix.com/engineering-reference/api/notifications.md#post-v3schedulerreminder-notification)).
* A planner with a reminder is deleted on its reminder day if its group is inactive or deleted \[[ASK-54](https://github.com/snapfix/docs/blob/main/ASK.md#ask-54-should-a-planner-restart-when-its-group-is-reactivated)].

### Scheduler timing

* The scheduler sends each reminder that falls due within the next 10 minutes, so a reminder can come up to 10 minutes early (py\_scheduler @ c8b1344036, `config/constant.py:128`, `models/cron_schedule_v3.py:104-116`).
* A new run starts at least 5 minutes after the last one finished, and a run still in progress blocks the next (`models/cron_schedule_v3.py:87`, `schedulev3.py:5-7`). How often the server starts the script is not in the repos \[[ASK-13](https://github.com/snapfix/docs/blob/main/ASK.md#ask-13-which-services-and-scheduled-jobs-run-in-production)].
* The scheduler moves each personal reminder on to its next time whatever the push service answers (`models/cron_schedule_v3.py:172-215`).
* A reminder whose group is inactive or deleted is marked deleted and sends nothing more (`models/cron_schedule_v3.py:150-170`).
* The push service reads each member's group mute from a cache that a separate script fills \[[ASK-13](https://github.com/snapfix/docs/blob/main/ASK.md#ask-13-which-services-and-scheduled-jobs-run-in-production)] ([Push delivery](https://docs.snapfix.com/engineering-reference/api/notifications.md#push-delivery)).

### Not reachable

* Both apps hold a daily reminder for a task's assigned users, but nothing opens it: Android's menu item is always hidden and no iOS screen opens `TaskReminderVC` \[[ASK-10](https://github.com/snapfix/docs/blob/main/ASK.md#ask-10-which-differences-between-the-ios-and-android-apps-are-intended)] ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#checklist-time-range-time-and-cost-reminder)).

### Limits and plans

* No plan or paywall check applies to reminders.

## Flow

```mermaid
flowchart TD
  set["Person sets Remind me, or a due date with Repeat reminder daily"] --> saved["Schedule saved in site time, chat line written"]
  saved --> due{"Due within the next 10 minutes?"}
  due -- no --> wait["Next scheduler run"]
  wait --> due
  due -- yes --> live{"Task, group and site live, with an assignee?"}
  live -- no --> nothing["No push"]
  live -- yes --> push["Push to each assignee and a chat line"]
  push --> repeat{"Once or daily?"}
  repeat -- once --> off["Reminder switched off"]
  repeat -- daily --> nextday["Next day, same time"]
  nextday --> due
```

## Platforms

| Capability                        | Web               | iOS                                                                                                                                                | Android                                                                                                                                            |
| --------------------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Personal reminder on one task     | Yes, "Remind me"  | Yes                                                                                                                                                | Yes                                                                                                                                                |
| Once or every day                 | Yes               | Yes                                                                                                                                                | Yes                                                                                                                                                |
| Default date and time             | Tomorrow, 8:00 AM | Not checked                                                                                                                                        | Not checked                                                                                                                                        |
| Reminder on several tasks         | No                | Yes, "More" > "Set Reminder"                                                                                                                       | Yes, "More" > "Set Reminder"                                                                                                                       |
| Due-date daily reminder           | Yes               | Yes                                                                                                                                                | Yes; the first time the daily choice is dropped                                                                                                    |
| Planned-task reminder             | Yes               | Yes                                                                                                                                                | Yes                                                                                                                                                |
| Daily reminder for assigned users | No                | Not reachable \[[ASK-10](https://github.com/snapfix/docs/blob/main/ASK.md#ask-10-which-differences-between-the-ios-and-android-apps-are-intended)] | Not reachable \[[ASK-10](https://github.com/snapfix/docs/blob/main/ASK.md#ask-10-which-differences-between-the-ios-and-android-apps-are-intended)] |
| Receives reminder pushes          | No                | Yes                                                                                                                                                | Yes                                                                                                                                                |

## Screens

* [Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#remind-me): "Remind me", and the due date in [Set due date](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#set-due-date).
* [Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#multi-select): a reminder on several tasks, in the apps.
* [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md): the planner's reminder.
* [Notification settings](https://docs.snapfix.com/how-the-apps-work/screens/notifications/settings.md#inputs): the "When a Reminder is activated" switch.

## API and data

* [`GET`](https://docs.snapfix.com/engineering-reference/api/tasks.md#get-job-reminderjob_uuid), [`POST`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-job-reminderjob_uuid) and [`DELETE /job-reminder/{job_uuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#delete-job-reminderjob_uuid): a task's personal reminder. [`POST /job-reminders`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-job-reminders): the same reminder on several tasks. The fields are in the [Reminder object](https://docs.snapfix.com/engineering-reference/api/tasks.md#reminder-object-apipy).
* [`POST /v1/app/tasks/{uuid}/due-date`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksuuiddue-date), [`PUT`](https://docs.snapfix.com/engineering-reference/api/tasks.md#put-v1apptasksuuiddue-date) and [`DELETE`](https://docs.snapfix.com/engineering-reference/api/tasks.md#delete-v1apptasksuuiddue-date): a due date and its daily reminder.
* The scheduler's calls: [`POST /job/reminder-notification-v2`](https://docs.snapfix.com/engineering-reference/api/notifications.md#post-jobreminder-notification-v2) (personal reminders), [`POST /job/due-reminder-notification`](https://docs.snapfix.com/engineering-reference/api/notifications.md#post-jobdue-reminder-notification) (due dates) and [`POST /v3/scheduler/reminder-notification`](https://docs.snapfix.com/engineering-reference/api/notifications.md#post-v3schedulerreminder-notification) (planners). They need no login; the scheduler sends a login written in its code.
* Tables: [`schedule_v3`](https://docs.snapfix.com/engineering-reference/db/tables/schedule_v3.md) (one row per reminder: category `tasknotif` for personal reminders, `duedatenotif` for due dates, and planner rows with their reminder), [`tPri_Job`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_job.md) (`fEnableTaskReminder`, `uuid_tUserEnableTaskReminder`, `fDueDateTs`, `fDueDateDailyReminder`), [`tPri_JobReminder`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_jobreminder.md) (a reminder row per task, which the reminder push moves on to the next day only when the task has no live assignee) and [`tPri_JobChat`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_jobchat.md) (the chat lines).

## Depends on

* [Push notifications](https://docs.snapfix.com/product/features/notifications/push-notifications.md): the pushes, the switches and the silent pushes.
* [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md): assignees, the due date, and the task's status, archive and deletion.
* [Task chat](https://docs.snapfix.com/product/features/chat/task-chat.md): the reminder and due-date lines.
* [Planned tasks](https://docs.snapfix.com/product/features/planner/planned-tasks.md): the planner that holds a planned-task reminder.
* [Multi-select](https://docs.snapfix.com/product/features/tasks/multi-select.md): a reminder on several tasks.
* [Groups](https://docs.snapfix.com/product/features/groups/groups.md): the site's time zone, and whether the group is inactive or deleted.
* [Staff schedule](https://docs.snapfix.com/product/features/housekeeping/staff-schedule.md) and [Cleaning tasks](https://docs.snapfix.com/product/features/housekeeping/cleaning-tasks.md): who may set a reminder on a housekeeping task.

## Edge cases

* **Offline (apps):** setting a reminder or a due date needs a connection ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#states)).
* **Deleted task:** the scheduler still calls, and nothing is sent ("invalid job") ([`POST /job/reminder-notification-v2`](https://docs.snapfix.com/engineering-reference/api/notifications.md#post-jobreminder-notification-v2)).
* **No assignee:** nothing is sent ("invalid job assignees"). The person who set the reminder misses it only if someone unassigned them afterwards.
* **Green or archived task:** personal reminders keep firing; due-date reminders stop.
* **Unchanged save on the web:** "Apply" saves even when nothing changed, and notifies people again.
* **Muted group:** reminder pushes follow the mute only as far as its cache is up to date \[[ASK-13](https://github.com/snapfix/docs/blob/main/ASK.md#ask-13-which-services-and-scheduled-jobs-run-in-production)].
* **Defaults:** the apps show "When a Reminder is activated" off until the server's settings arrive, while the settings table defaults it to on \[[ASK-171](https://github.com/snapfix/docs/blob/main/ASK.md#ask-171-what-should-four-notification-switches-default-to)].
* **Time zones:** every reminder uses the site's time zone, Europe/Dublin when the site has none.
* **Several sites:** each reminder belongs to one task, and so to one site and its time zone.


---

# 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/notifications/reminders.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.
