# Notifications & Tasks Overview (/docs/notifications/overview)



Layers ships two distinct systems:

* **Notifications** — real-time in-app messages surfaced via the bell
  icon, optionally interactive (confirm / select an option / enter a
  value).
* **Tasks** — a generalized onboarding-task system that rewards
  organization credits when you complete milestones (currently scoped
  to onboarding).

## Where they live [#where-they-live]

* **Notification bell** in the top nav — dropdown shows unread and
  archived notifications with "Mark all as read" and an archived
  toggle. Updates live via a realtime subscription.
* **Onboarding tasks widget** on the dashboard — lists outstanding
  onboarding tasks with credit reward amounts and CTAs.

There is no email, Slack, mobile push, SMS, or desktop-toast delivery
for notifications today. The notification system is in-app only.
Push notifications for the mobile app are deferred.

## Notification types [#notification-types]

| Type           | Meaning                                           |
| -------------- | ------------------------------------------------- |
| `broadcast`    | Informational, no response expected.              |
| `confirmation` | Binary decision (confirm / reject).               |
| `selection`    | Pick one from a predefined list of options.       |
| `input`        | Submit a typed value (text, number, or currency). |

Interactive types (`confirmation`, `selection`, `input`) reference an
allow-listed `action_key` that maps to a server endpoint; when the
user responds, Layers executes the action and records the outcome.
The current allow-list is small — `approve_content`,
`reject_content`, `adjust_spend_cap`, `acknowledge`.

## Notification scopes [#notification-scopes]

| Scope          | Fan-out                           |
| -------------- | --------------------------------- |
| `user`         | Single user's inbox.              |
| `project`      | Every member of the project.      |
| `organization` | Every member of the organization. |

## Priority [#priority]

Each notification carries one of four priorities:
`low`, `normal`, `high`, `urgent`. Priority drives the default icon
(Info / Bell / AlertTriangle / AlertCircle) when one isn't explicitly
set. It does not trigger different delivery channels — all
notifications deliver in-app.

## Quick links [#quick-links]

* [Catalog](/docs/notifications/catalog) — the source types and
  registered actions.
* [Tasks](/docs/notifications/tasks) — the onboarding-credit task
  system.