# Alerts Alerts is your inbox for shared work: mentions, tasks teammates add to your day, status and GitHub updates you choose to follow, and comment drafts you have not posted yet. Open it from the standalone bell icon in the sidebar (it shows a count badge when you have unread notifications), or press `Shift + A`. See also: [[Team Comments and Mentions]] and [[Planning Team Work]]. ![[team-notifications-inbox.png]] ## Four tabs | Tab | What's in it | |-----|--------------| | **Inbox** | Active notifications: mentions, tasks added to your day, and status changes you've opted into | | **Sent** | Notifications you triggered (for example, people you've @mentioned) | | **Cleared** | Notifications you've cleared, kept for reference. You can restore any of them | | **Drafts** | Comments you started writing but did not post, on any task | > [!tip] Open Alerts from the keyboard > Press `Shift + A` from a non-editing area to open Alerts. `B` is reserved for breaks on a running Planning timer when Track breaks is enabled. ## What triggers a notification - **Mentions**: someone @mentions you in a task comment - **Tasks added to your day**: a teammate plans a task into your day or inbox - **Status changes**: a task reaches a status you've opted into (off by default, see below) - **Git activity**: commits and pull requests land on your tasks through the [[GitHub Integration]] Each notification shows who it's from (with their real profile picture), the task it's about, the project label, and the task's current **status**, so you can judge what needs attention at a glance. ## Status-change notifications Opt in to hear the moment a task reaches a stage you care about, such as In Progress, In Review or Done, without being buried in every other transition. ![[team-notification-settings.png|520]] - **Per-status checkboxes**: The preferences list your project's own statuses, so you pick exactly which target statuses notify you - **Your tasks or all tasks**: Choose whether to be notified only for tasks assigned to you, or for every task in the project - **Personal and off by default**: Each member manages their own preferences, one member's choices do not affect another's, and nobody receives status notifications until they opt in - **Shows the transition**: The notification names the task and the change itself (from which status to which) alongside the usual project, actor, and time, with its own icon so it reads differently from a mention at a glance - **No self-notifications**: You're not notified about a status change you made yourself Open the preferences from the **gear** in the notifications area, or from the small manage control on any status-change notification, so tuning or stopping them is one click from the notification itself. The notifications empty state also links to the preferences, so the controls are discoverable even before you've received anything. > [!tip] Subscribe to the stages that matter to you > A reviewer might opt into just "Testing: Ready"; a lead might opt into "Blocked". Pick the transitions you'd act on, and let the rest stay quiet. ## GitHub notifications GitHub notifications are off until you opt in for a project. Open **Team Settings → Notifications** and enable **GitHub notifications** to hear about commits, branches, pull requests, and reviews on tasks you created or are assigned to. ![[team-github-notification-toggle.png]] - **Off by default**: A member with no saved GitHub preference receives no GitHub notification volume - **Your choice is preserved**: An explicitly saved on or off selection remains unchanged - **Activity still stays on the task**: The [[GitHub Integration|GitHub panel and activity feed]] continue recording development activity even when notifications are off ## Read and unread states Unread notifications use a neutral surface, slightly stronger text, and the unread dot instead of a blue full-row background. The same treatment appears on the Notifications page and in the bell menu, in both light and dark themes. Opening a row gives selection its own accent treatment, so selected, hovered, focused, read, and unread states remain distinct without competing with project and status colours. ## Filter your inbox The inbox has two filters: - **Unread**: show only notifications you haven't read - **Project**: show only notifications from one project > [!note] Built for many projects > The project filter helps once you're active across several boards. Narrow the inbox to just the project you're focused on. ## Navigate with a task panel open In the **Rows** layout, press **Up** or **Down** to open the previous or next alert in the task panel. This also works with the Unread filter. Press **Escape** to return focus to the last row shown. The arrow keys keep their usual behaviour when you are typing or using a menu, dialog, or media control. For a top-level task, the preview header includes a reading-width control beside **Pin**. This Pin control pins the task to the team list. To pin the notification itself, use the notification's right-click menu. ![[alerts-task-header.png|491]] ## Clear quickly with E With the task panel closed, hover a notification and press `E` to clear it. Cleared notifications move to the **Cleared** tab, where you can restore any of them later. > [!highlight] Keyboard-first cleanup > Hover, press `E`, move on. Clearing is reversible. Nothing is deleted; it moves to Cleared. ## Other actions - **Right-click** any notification to mark it read or unread, or to **pin** it - **Pin to the top**: A pinned notification stays at the top of your Inbox until you unpin it, no matter which tab it came from: Inbox, Sent or Cleared. Pin something you sent to keep tabs on it; a **Sent badge** marks it apart from notifications you received - **Mark all read** and **Clear all** live under the **•••** More menu at the top of the Inbox tab. Clearing everything asks for a quick confirmation first - **Funnel icon** next to the More menu toggles the Unread/Project filter bar - **Open** a notification to jump directly into the Comments view, with the specific comment that triggered it highlighted, or open it full-page - If the task a notification points at has since been **deleted**, opening it shows a clear "This task has been deleted" state with an option to clear the notification, and the rest of your inbox stays usable - **Restore** moves a cleared notification back to the inbox ## Browser alerts If your browser supports it, you can enable browser notifications so a mention reaches you even when Zaphiri isn't the active tab (while Zaphiri is open). Enable it from the notifications page. Zaphiri asks your browser's permission first. A backgrounded tab (open but not the active tab or window) also shows an unread count badge directly in the browser tab title, alongside the existing favicon dot. That means an @mention is visible from the OS tab strip or window switcher without needing to click back into the tab. ## Unposted comment drafts The **Drafts** tab lists comments you started without posting, so you can return to them from one place. - Each entry shows the task the draft belongs to and a preview of what you wrote - The bell carries a count so you know drafts are waiting without opening anything - Click a draft to open its task with your text restored, exactly where you left it - **Discard** clears a draft you no longer want, with a quick inline confirmation, without opening the task first > [!note] Drafts are per device > An unposted draft lives in the browser you wrote it in, so a draft started on your laptop won't appear on your phone. Post the comment to get it onto the task itself. Drafts also clear when you log out. > [!success] One place for shared signals > Mentions, day additions, and unfinished drafts all land here. Filter to focus, press `E` to clear, and restore anything you need from Cleared. --- **Next:** Tune the project in [[Time Tracking and Settings]].