> ## Documentation Index
> Fetch the complete documentation index at: https://docs.terracetech.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

> The bell, your inbox, Scout alerts, and how to choose what reaches you and where.

Notifications tell you when something you care about happens: a new order, a delivery completed, a QuickBooks sync that failed, a task assigned to you. Each notification can reach you in the app, as a phone push, or by email. You choose which.

Settings › Account › Notifications

## The bell

The bell sits on the green band of most work pages: Orders, Customers, Calendar, Trucking, Invoices, Inventory, a product's page, Crops, Locations, Operations and Bookings. Its count covers unread notifications and Scout alerts together, up to **99+**.

The Dashboard has no bell. Its **Scout & alerts** card does that job. See [Dashboard](https://docs.terracetech.co/guides/dashboard.md).

Click the bell to open the **Notifications** panel over the page:

* Switch between **Unread** and **All**.
* **Scout alerts** sit at the top, up to three at a time.
* Updates are grouped under **Today**, **Yesterday** and **Earlier**.
* Several updates about the same order are grouped into one row, for example **3 updates**.
* **Mark all read** clears the count. **View all** opens your full inbox.
* When there's nothing new, it says **You're all caught up**.

## Your inbox

The full inbox is in **Settings › Account › Notifications**. Use it to go back through older updates or tidy up.

* **Unread** or **All**, and an area filter: **All areas**, **Orders**, **Deliveries**, **QuickBooks** or **Projects**.
* **Mark all read** marks everything read.
* **Clear read** deletes every read notification after you confirm.
* **Load older notifications** goes further back.

Each row has a menu:

| Option | Does |
| - | - |
| **Why you got this** | Explains why the notification reached you. |
| **Mark read** | Marks it read. |
| **Stop these** | Opens notification settings with that kind of notification highlighted, so you can turn it off. |
| **Delete** | Deletes it. On a grouped row, **Delete all updates** removes the group. |

### Scout alerts

A **Scout alerts** card sits at the top of the inbox: "Things on your farm that need a look." Each alert shows its level, High Medium or Low, and may carry an action button.

* **Mark read** marks the alert read for you only.
* **Dismiss for everyone** clears it for the whole farm. A snackbar then says **Insight dismissed** and offers **Add reason**, which teaches Scout what's normal for your farm.

See [Scout](https://docs.terracetech.co/guides/scout.md) for what each alert means and how to tune them.

## Choose what reaches you

Settings › Account › Notification settings

Notifications are grouped by area. Each row is one kind of notification, with three checkboxes:

* **In-app**: in the bell and your inbox.
* **Push**: to your phone, through the Terrace phone app.
* **Email**: by email.

These are your own settings. Changing them doesn't affect anyone else on the farm.

> [tab] Orders
>
> * New order
> * New quote
> * Saved as a draft
> * Pending
> * Awaiting harvest
> * Harvested
> * On hold
> * Completed
> * Cancelled
> * Other status changes

> [tab] Deliveries
>
> * Ready for pickup
> * In transit
> * Delivered
> * Assigned to you
> * Delivery started
> * Delivery completed
> * Delivered short

> [tab] QuickBooks
>
> * Out of sync
> * Sync failed
> * Excluded invoice exported

> [tab] Projects
>
> * Task assigned
> * Tasks due, a morning summary of what's due
> * Task blocked, sent to the project lead

> [tab] Scout
>
> * Unusual orders
> * Missing regular orders
> * Customer activity
> * Inventory
> * Overdue invoices
> * Morning rundown (off until you turn it on)

> [!TIP]
>
> The fastest way to turn something off is from the notification itself. Open its menu and choose **Stop these**.

### Pop-up alerts

On the web, new notifications can also slide in as pop-ups while you work. In the **Pop-up alerts** card:

* **Show pop-ups** turns them on or off.
* Choose where they appear: **Top left**, **Top center**, **Top right**, **Bottom left**, **Bottom center** or **Bottom right**.

Pop-ups look like inbox rows and disappear after five seconds.

## On your phone

Push notifications come only through the Terrace phone app. There are no browser push notifications on the web, which uses the bell, the inbox and pop-ups. Tap a push notification and the app opens the same place the inbox would.

In the phone app:

* **More › Notifications** shows the same inbox, with a link to **Notification settings**.
* **More › Settings › Notifications** opens **Notification settings**. It starts with **How you're notified** on this device (**Push notifications** and **In-app pop-ups**), then the same rows as the web, with **In-app**, **Push** and **Email** choices for each type. Changes save as you make them.

> [!NOTE]
>
> If push notifications don't arrive, check two places. First, **Push notifications** and the **Push** choice on that type in **Notification settings**. Second, your phone's own settings for the Terrace app. If notifications are turned off there, Terrace shows **Open device settings** to take you to them.

## Related

> [card] [Scout](https://docs.terracetech.co/guides/scout.md)
>
> What Scout watches, and how to tune its alerts.

> [card] [Settings](https://docs.terracetech.co/guides/settings.md)
>
> Every section of Settings, tab by tab.

> [card] [Projects](https://docs.terracetech.co/guides/projects.md)
>
> Tasks that send notifications when assigned, due or blocked.

> [card] [Terrace on mobile](https://docs.terracetech.co/guides/mobile.md)
>
> The phone app, where push notifications live.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.