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

# Notifications

> Where notifications appear, how long they are kept, and how to control what reaches you

# Notifications

Notifications are how work that happened without you gets back to you: a task reassigned, a
colleague mentioning you in a conversation, Abbie finishing a run or needing a decision.

## Where they appear

<Steps>
  <Step title="The bell">
    The bell in the sidebar carries a dot whenever anything is unread.
  </Step>

  <Step title="The panel">
    Opening it lists the most recent notifications. When there are unread ones, the header shows
    an **N unread** pill and a **Mark all as read** action; each row can be marked read on its
    own. With nothing waiting it says so: *Nothing new. Updates, assignments and mentions land
    here.*
  </Step>

  <Step title="The full history">
    **View all notifications** at the foot of the panel opens the history page, which filters by
    period (Today, Yesterday, This week) and by type, has an **Unread only** toggle, and offers
    **Clear filters** and **Mark all as read**.
  </Step>
</Steps>

<Note>
  Notifications are stored for one week. The history page replays what is retained, so a week is
  the whole of what it can ever show.
</Note>

<Info>
  The Conversations sidebar itself carries no per-conversation unread count. Unread state lives on
  the bell.
</Info>

## Choosing what reaches you

**Settings → Notifications**. Preferences are set per notification kind, and each kind's
supported channels — in-app, email — are switched independently.

### Tasks

In-app and email:

* Status changes
* Assignment changes
* Mentions
* Watcher updates

<Note>
  Task mentions are always delivered in-app. That switch is locked rather than hidden, so it is
  clear it is deliberate.
</Note>

### Abbie

In-app only — email is not available for these yet:

| Kind                   | Fires when                                                |
| ---------------------- | --------------------------------------------------------- |
| Abbie run completed    | A run finishes.                                           |
| Abbie check-ins        | Abbie checks in after you have gone quiet for a while.    |
| Abbie follow-ups       | Something is parked waiting on you.                       |
| Abbie suggestions      | Abbie has a suggestion for you.                           |
| Conversation mentions  | A colleague mentions you in a conversation.               |
| Rapport suggestions    | Abbie proposes a change to how she works with you.        |
| Correction suggestions | Abbie drafts a correction from something that went wrong. |
| Skill suggestions      | Abbie drafts a new skill for review.                      |
| Authorisation requests | Abbie needs your authorisation to continue.               |
| Decision requests      | Abbie needs you to choose between options.                |

Authorisation and decision requests are split out from the rest deliberately: muting the chasing
of parked work should not also mute a prompt that is blocking real progress.

### Billing

In-app only:

* **Low credit balance** — your balance has dropped to a warning level, before it runs out.
* **Auto top-up failed** — an automatic top-up could not be charged. Retries pause until the
  balance recovers, so this is the only warning you get.

## Delivery

Two account-wide controls sit below the kinds:

* **Email grouping** — Real-time, Hourly digest or Daily digest. This governs email only; in-app
  delivery is unaffected.
* **Quiet hours** — off by default. Turn it on and set a **from** and **to** time to pause
  notifications between them. Mentions still come through. The window follows the timezone on
  your profile, which the setting names so there is no guessing.

<Warning>
  There is no snooze or do-not-disturb control on the bell. Quiet hours and the per-kind switches
  are how notifications are quietened.
</Warning>

## Related

<CardGroup cols={2}>
  <Card title="@Mentions" icon="at" href="/collaboration/at-mention-guide">
    What generates a conversation mention in the first place.
  </Card>

  <Card title="Team Practices" icon="people-group" href="/collaboration/team-best-practices">
    Habits that keep the volume down without muting the things that matter.
  </Card>
</CardGroup>