feat: Add task notifications documentation (#1992)

jonathanbataire · andrablaj · web-flow · commit 4c2562fbbce8 · 2026-02-04T10:29:11.000+03:00
* Update content/en/building/tasks/tasks-overview.md

Co-authored-by: Andra Blaj &lt;andra@medic.org&gt;

* Update content/en/building/tasks/tasks-overview.md

Co-authored-by: Andra Blaj &lt;andra@medic.org&gt;

* clean up

* more clean up

* address feedback

* add image

---------

Co-authored-by: Andra Blaj &lt;andra@medic.org&gt;
diff --git a/content/en/building/branding/android.md b/content/en/building/branding/android.md
@@ -47,6 +47,7 @@ To proceed you need to have ready the following:
 
 - The URL of your CHT server so users don't have to type it in post install.
 - The app logo and title.
+- Notification icon.
 - Translations for your supported languages (most flavors don't need to customize translations though).
 
 Also be sure to have a working **[Development Environment](/community/contributing/code/android/development-setup)**.
diff --git a/content/en/building/reference/app-settings/_index.md b/content/en/building/reference/app-settings/_index.md
@@ -47,6 +47,7 @@ The following settings do not need to be specified. They should only be defined
 | outgoing_deny_with_alphas        | When `true`, deny all messages to recipient phone numbers containing letters (eg. `Safaricom`). Intended to avoid [message loops]({{% ref "building/messaging/message-loops" %}}) with non-numeric senders used by gateways. A boolean.                                                                                                                                                                                                                                            | true    | 3.3.0   |
 | outgoing_deny_with_alphas        | When `true`, deny all messages to recipient phone numbers containing letters (eg. `Safaricom`). Intended to avoid [message loops]({{% ref "building/messaging/message-loops" %}}) with non-numeric senders used by gateways. A boolean.                                                                                                                                                                                                                                            | true    | 3.3.0   |
 | task_day_limit                   | The number of days before a task is due to show the due date.                                                                                                                                                                                                                                                                                                                                                                                                                         | 4       | 3.9.0   |
+| max_task_notifications                   | The maximum number of task notifications to show at once.                                                                                                                                                                                                                                                                                                                                                                                                                         | 8       | 5.1.0   |
 | app_url                          | The URL of the app, eg: "https://demo.app.medicmobile.org"                                                                                                                                                                                                                                                                                                                                                                                                                            |         | 3.10.0  |
 | task_days_overdue                | Display number of overdue days in tasks list                                                                                                                                                                                                                                                                                                                                                                                                                                          | false   | 3.13.0  |
 | languages                        | Array of objects with `locale` and `enabled` properties representing respectively the 2 or 3 letter language code and whether that language should be enabled.  <br/>If unset it falls back to the previous behavior of relying on the `enabled` property of each translation document `messages-XX.properties`. This fallback behavior is now deprecated and will be removed in the next major version (5.0). This `languages` configuration property will be required for CHT 5.0+. |         | 4.2.0   |
diff --git a/content/en/building/reference/app-settings/user-permissions.md b/content/en/building/reference/app-settings/user-permissions.md
@@ -43,6 +43,7 @@ Permissions can be assigned to user roles either directly in `base_settings.json
 | `can_export_dhis` | Allows export of DHIS2 metrics                                                                                                                                                                                                                                                                                                                                                                |
 | `can_export_feedback` | Allows export of user feedback                                                                                                                                                                                                                                                                                                                                                                |
 | `can_export_messages` | Allows export of reports and messages                                                                                                                                                                                                                                                                                                                                                         |
+| `can_get_task_notifications` | 	Allows users to receive task notifications                                                                                                                                                                                                                                                                                                                                                                                                                |
 | `can_log_out_on_android` | 	Displays logout menu item in hamburger menu for Android users and can be used to log out from the application                                                                                                                                                                                                                                                                                |
 | `can_update_places` | Allows editing of place documents                                                                                                                                                                                                                                                                                                                                                             |
 | `can_update_reports` | Allows editing of report documents                                                                                                                                                                                                                                                                                                                                                            |
diff --git a/content/en/building/tasks/tasks-overview.md b/content/en/building/tasks/tasks-overview.md
@@ -54,6 +54,23 @@ Older configurations that do not implement the new priority score will continue
 {{< card link="tasks-prioritization.png" image="tasks-prioritization.png"  method="resize">}}
 {{< /cards >}}
 
+
+
+## Android task alerts/notifications
+
+{{< callout >}}
+Available from CHT Core 5.1.0 and CHT Android 1.7.0.
+{{< /callout >}}
+
+Android notifications can be configured to remind users of their tasks. When this [permission]({{< relref "building/reference/app-settings/user-permissions" >}}) is active, a notification is sent daily for each due or overdue task, up to a defined limit. Each notification displays the specific task title and description. The notification content is customizable and can be [translated]({{< relref "building/translations/localizing" >}}) via the `android.notification.tasks.contentText` key, which supports the following parameters:
+- `taskTitle` The task title.
+- `contact` The contact that the task is about.
+
+{{< figure src="tasks-notification.jpg" link="tasks-notification.jpg" caption="A task notification." >}}
+
+Additional configuration can be done in the [app settings]({{< relref "building/reference/app-settings" >}}) to control the maximum number of notifications that can be shown at once.
+
+
 ### Quick guides 
 
 For more details and guides, see the following sections:
diff --git a/content/en/building/tasks/tasks-overview/tasks-notification.jpg b/content/en/building/tasks/tasks-overview/tasks-notification.jpg
