> For the complete documentation index, see [llms.txt](https://openup.gitbook.io/cape-agulhas-app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://openup.gitbook.io/cape-agulhas-app/administrator-guide/notices-and-notifications.md).

# Notices and Notifications

Notices are pages with a short announcement inside the app. Notifications are alerts shown on a device. When a user taps/clicks on a notification, it opens the URL included in the notification.

{% hint style="info" %}
Notice vs Notification

The difference between a notice and notification is important. A notice is a specific type of page in the app. A notification is an alert outside the app that prompts users to visit the app.
{% endhint %}

We can use notifications to bring the user's attention to an important matter - e.g. a notice.

{% embed url="<https://youtu.be/Lqu2FDSGqwg>" %}

## Creating a notice

Notices are children of the Notice Index page.

Go to the Notice Index Page titled "Notices" and click on Add Child Page.

![](https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MOgvsx1WXS2GgnPj3eV%2F-MOgzNl8KVzUjuS2UJW5%2FScreenshot_2020-12-16_21-06-17.png?alt=media\&token=4c1fe025-ab94-45b1-9d75-ce9d05173f4f)

Create your notice with a clear brief title and content. When you are ready, click Publish to make the notice publicly-visible.

![Creating and publishing a notice](https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MOgvsx1WXS2GgnPj3eV%2F-MOgzthdaVJ8PsMVAsa9%2FScreenshot_2020-12-16_21-07-15.png?alt=media\&token=9d954852-0abf-4666-b737-8df3f3e76342)

&#x20;You can now see the notice in the app.

![A notice shown in the app](https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MOgvsx1WXS2GgnPj3eV%2F-MOgyH13nXHAzB_5BRqx%2FScreenshot_20201216-211231_Chrome.jpg?alt=media\&token=19996e38-8abd-4d87-bad0-0a93a93faf7a)

## Sending notifications

Notifications are only delivered to users who have subscribed to in-app notifications.

![A notification shown on a device](https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MOgvsx1WXS2GgnPj3eV%2F-MOgyhcbopL5oliVbM5o%2FScreenshot_20201216-210821_One%20UI%20Home.jpg?alt=media\&token=ae30bdd8-5872-4beb-a012-79856f9ff831)

You can create a notification by opening the PushPad project named "Cape Agulhas App" for normal production use. The other projects are for [other environments of the app.](/cape-agulhas-app/administrator-guide/app-environments.md)

![](https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MYHFGLj9RwWXRGNa1FP%2F-MYHFR4Mga2YbTbEMil6%2FScreenshot_2021-04-14_23-05-06.png?alt=media\&token=1f9a8213-7bea-4522-8a80-69972b51ba81)

Fill in the notification title, message and URL. The title and body must be kept very brief - most devices only show a few words. The URL will be opened by the app when the user taps on the notification. Double-check the URL before creating the notification.

![](https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MYHFGLj9RwWXRGNa1FP%2F-MYHGPvZvKUodR2B2pS7%2FScreenshot_2021-04-14_23-23-58.png?alt=media\&token=e805dbad-85a4-44c2-9b81-3504e8b88b5f)

If you would like to announce a notice using a notification, you can visit the notice in your browser, and copy its URL from the address bar at the top of your browser - use that as the URL in your notification.

![](https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MOh0GCA65XBmQsSbDCn%2F-MOh2YkMIhbWQg4sfM2U%2FScreenshot_2020-12-16_21-05-38.png?alt=media\&token=3d228245-ae89-4025-8410-4dfd6b7a81a1)