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

# Notifications

> The notification center, what types fire, and per-user email opt-in/out.

HoLaCe's notification system surfaces in-app alerts and (optionally) email for every event that affects you — assignments, status changes, document uploads, deadlines, and system messages. The notification center is the bell icon in the top-right of the dashboard.

\[Screenshot: Notification center dropdown showing recent unread notifications with type icons and timestamps]

## Where notifications appear

| Surface                          | What you see                                                                                                  |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Bell icon** in top bar         | Unread count badge; click to expand the dropdown                                                              |
| **Notification center dropdown** | Latest 20 notifications, mark-all-read button, link to full page                                              |
| **Sidebar → Notifications**      | Full paginated history, filterable by type and read/unread                                                    |
| **Email**                        | Optional per type — controlled in your [User Profile](/admin-cross-cutting/settings/user-profile) preferences |

Click any notification to mark it read and jump to the relevant journey, task, or document.

## Notification types

| Type                   | Fires when                                                          |
| ---------------------- | ------------------------------------------------------------------- |
| `ASSIGNMENT_NEW`       | A journey or task is assigned to you                                |
| `ASSIGNMENT_ACCEPTED`  | A service provider accepts a job you assigned                       |
| `ASSIGNMENT_DECLINED`  | A service provider declines, or a task you owned is reassigned away |
| `MESSAGE_NEW`          | A new message lands on a journey or service request you're on       |
| `STATUS_CHANGED`       | A journey, task, or service request changes status meaningfully     |
| `PAYMENT_RECEIVED`     | A settlement disbursement payment is recorded                       |
| `DOCUMENT_UPLOADED`    | A document is added to a journey you're on                          |
| `DEADLINE_APPROACHING` | A statute, demand response, or hearing deadline is N days away      |
| `SYSTEM_ALERT`         | HoLaCe-wide announcements (planned maintenance, new releases)       |

Each type has a sensible default — `ASSIGNMENT_NEW` is loud (in-app + email by default), `DOCUMENT_UPLOADED` is quieter (in-app only by default unless you opt in to email).

## Email opt-in / opt-out

Open **Settings → User Profile → Notifications**. You'll see each notification type with two toggles:

* **In-app** — show in the notification center. Default on.
* **Email** — also send an email. Defaults vary by type.

Toggle either independently. Changes apply to future notifications immediately.

If you want quiet for a week (vacation, deep-focus stretch), use the **Pause notifications** button at the top of the preferences page. Pause for a duration; everything resumes automatically.

## Read state and cleanup

* Click a notification → marks read.
* "Mark all read" in the dropdown → reads everything in one action.
* Notifications older than 90 days auto-expire from the center (the underlying audit log retains them for compliance).

## Priority

Each notification has a `priority` field — `low`, `normal`, `high`, `urgent`. The notification center uses priority to:

* Sort the dropdown (urgent first)
* Decide whether to surface a desktop browser push (urgent only, if you've allowed it)
* Color the badge (urgent unread count is red, others are blue)

`DEADLINE_APPROACHING` and roadblock-related notifications generally fire at high or urgent priority. Routine document uploads stay normal.

## What if notifications stop arriving?

Three usual culprits:

1. **You've opted out** — check Settings → Notifications.
2. **Email is being filtered** — add the HoLaCe domain to your safe senders list.
3. **You're paused** — the pause toggle is on. Click resume.

If in-app notifications stop without those reasons, file a [bug report](/admin-cross-cutting/support/in-app-bug-button) — that's a real bug.

<Note>
  Roadblocks specifically trigger notifications: see [Tasks → Roadblocks](/admin-cross-cutting/tasks/roadblocks).
  Notification preferences live in [Settings → User Profile](/admin-cross-cutting/settings/user-profile).
</Note>