Skip to main content
The notification tray SDK APIs expose in-app notification tray data for the signed-in user. Use them to render notification items, show a tray-level unread indicator, mark the tray as seen, and mark individual tray items as seen.
The current public Flutter SDK source reviewed for this page exposes push-notification registration and notification-settings APIs, but not notification tray item/status APIs.

​
SDK Surfaces

​
Data Model

Notification tray items are returned with actor, target, reference, action, text, and seen-state data. Property names differ slightly by platform. Tray seen status is a separate object with the latest tray occurrence timestamp, latest tray seen timestamp, and a derived isSeen value.

​
Typical Flow

  1. Observe tray seen status to decide whether to show a notification indicator.
  2. Query tray items when the user opens the notification tray.
  3. Mark the tray as seen after the user views the tray.
  4. Mark individual items as seen when the user views or opens a specific item.
  5. Dispose observers or subscriptions when the owning screen is destroyed.

Notification Items

Query tray items and mark individual items as seen

Tray Status

Observe and update tray-level seen status

Event Fields

Reference action and category values returned on tray items