Using the Inbox

View, filter, and manage your in-app notifications with the Inbox.

The Inbox is your central hub for all in-app notifications. It uses a two-panel layout so you can browse your notification list on the left and view full details on the right.

Accessing the Inbox

Click Inbox in the sidebar navigation. If you have unread notifications, a badge with the unread count appears next to the Inbox link.

Layout Overview

The Inbox is divided into two panels:

  • Left panel (notification list) -- Shows all your notifications grouped by date (for example, "Today", "Yesterday", "Last 7 Days"). Each row displays the notification title, category, severity, and a preview of the message. Unread notifications are visually distinct.
  • Right panel (detail view) -- When you click a notification in the list, its full content appears in this panel. If no notification is selected, you see a placeholder prompting you to select one.

On smaller screens, only the notification list is visible.

Filtering Notifications

Three filter dropdowns appear above the notification list:

Status Filter

Filter by read state:

  • All statuses -- Show all notifications.
  • Unread -- Show only notifications you have not read.
  • Read -- Show only notifications you have already read.

Category Filter

Filter by notification type:

  • All categories -- Show everything.
  • Individual categories such as Sharing, Integrations, Security, Billing, System, and Account.

Priority Filter

Filter by severity level:

  • All priorities -- Show everything.
  • Individual priority levels: info, success, warning, error, and critical.

Filters can be combined. For example, you can view only unread billing notifications. When filters are active and no results match, an empty state appears with an option to clear all filters.

Reading Notifications

Click any notification in the list to select it:

  1. The notification detail appears in the right panel.
  2. If the notification was unread, it is automatically marked as read.
  3. The unread badge count in the sidebar updates in real time.

Bulk Actions

You can select multiple notifications using checkboxes:

  1. Click the checkbox on the left side of each notification row to select it.
  2. When one or more notifications are selected, a bulk action bar appears with the number of selected items.
  3. Available bulk actions:
    • Mark as read -- Mark all selected notifications as read.
    • Delete -- Permanently remove the selected notifications from your inbox.
  4. Use the select-all checkbox to select or deselect all visible notifications at once.

Mark All as Read

To mark every notification in your inbox as read at once:

  1. Click the Mark all read button in the header area (next to the unread count badge).
  2. All notifications across all pages are marked as read.

Refreshing Notifications

Click the refresh button (circular arrow icon) in the inbox header to manually reload your notifications. Notifications also update in real time -- new notifications appear automatically without requiring a manual refresh.

Pagination

The inbox loads notifications in batches of 50. If you have more notifications than the initial batch:

  1. Scroll to the bottom of the notification list.
  2. Click Load more to fetch the next batch of older notifications.

Deleting Notifications

Deleting a notification removes it from your inbox. It does not affect other users who may have received the same notification.

To delete notifications:

  1. Select one or more notifications using the checkboxes.
  2. Click Delete in the bulk action bar.

Real-Time Updates

The inbox uses a real-time notification stream powered by Server-Sent Events (SSE). When new notifications arrive:

  • They appear at the top of your notification list automatically.
  • The unread badge count in the sidebar updates immediately.
  • If the SSE connection is unavailable, the inbox falls back to polling every 15 seconds to keep your notifications up to date.

See Also

Command Palette

Search for a command to run...