Notifications

The platform can notify you about jobs and sharing activity through toasts (brief on-screen alerts) and a Notifications inbox in the sidebar.

Both features depend on NATS eventing on the platform backend. Starting with the 2026.06.01 release, NATS is a required platform component. Your IT administrator must enable eventing before notifications work.

Preview feature

Notification toasts are off by default. Enable Notification toasts in Application settings → Experimental Features. See Settings.

Before you start

Feature	IT administrator setup	Your setup
Inbox page and sidebar badge	NATS + registry eventing	None — open Notifications in the sidebar
Toast alerts	NATS + registry eventing	Toggle Notification toasts in Application settings

Toasts can work without the inbox UI, but the summary toast's View inbox action only works when the inbox is enabled.

Enabling notifications for administrators

Notifications require NATS eventing in the registry service. All three backend settings below must be set; eventing stays off if any one is missing.

1. Deploy NATS — set nats.enabled: true in your Istari Platform Helm values. The chart deploys NATS in-cluster and injects FILE_SERVICE_NATS_URL into registry service pods.

2. Create the NATS secret — create the istari-nats Kubernetes secret with a shared auth token. See NATS Secret in the Istari Platform Installation guide.

3. Configure the registry service secret — add these keys to the istari-fileservice secret:

   FILE_SERVICE_NATS_TOKEN: "<nats_auth_token>" # Must match NATS_AUTH_TOKEN in istari-nats
   FILE_SERVICE_FEATURE_FLAGS__EVENTING_ENABLED: "true"

4. Redeploy the registry service — restart or upgrade so pods pick up the new values. On startup, the service exposes the V3 inbox API at /api/v3/inbox.

For upgrade steps when NATS was not previously enabled, see Migration Notes in the release notes.

Notification inbox

When enabled by your administrator, Notifications appears in the primary sidebar with an unread badge (1–9, or 9+ when there are ten or more unread items).

Open the inbox

Click Notifications in the sidebar, or follow View inbox from a summary toast.

The page has two tabs:

• Inbox — active notifications (read and unread)
• Archive — notifications you have archived

Read a notification

Click a notification row to open the detail pane on the right.

• Clicking an unread notification marks it as read and opens the detail pane.
• Clicking a read notification opens the detail pane without changing its read state.

Unread items show a blue dot beside the row. The page header shows how many notifications are unread.

The detail pane shows a summary of the event and an Open Job, Open System, or Open File link that navigates directly to the related resource.

Select and bulk actions

Use the checkboxes beside each notification (or Select all at the top of the list) to select one or more items. The header shows how many are selected and offers:

• Mark as read — marks all selected unread items as read
• Archive (Inbox tab) — moves selected items to the Archive tab
• Restore (Archive tab) — returns selected items to the Inbox tab
• Clear selection — deselects all items

Load more

The inbox loads notifications in pages. Click Load more at the bottom of the list to fetch older items.

What appears in the inbox

Event	Description
Resource access granted	Someone shared a file, model, or artifact with you
Job completed	A job you started finished successfully
Job failed	A job you started failed

Canceled jobs do not appear in the inbox.

Notification toasts

Notification toasts appear in the bottom-right corner of the platform while you work on other pages. They do not require the inbox to be enabled, but they do require backend eventing and your personal opt-in.

Enabling toasts

1. Click your avatar > Application.
2. Under Experimental Features, toggle Notification toasts on.

The setting persists across sessions on the same browser.

What triggers a toast

Event	Toast title
A job you triggered completes successfully	Job completed
A job you triggered fails	Job failed
Someone shares a file or model with you	File shared with you

Toasts only appear for events that occur during your current browser session. Activity from before you loaded the page is suppressed.

Individual toasts

When three or fewer notifications arrive at once, each one appears as its own toast with:

• A title describing the event
• A description — the job identifier or the name of the person who shared and the resource name
• A View button that navigates directly to the job or resource

Individual toasts dismiss automatically after ten seconds.

Summary toast

When four or more notifications arrive at the same time, a single summary toast appears instead:

• Title: X new notifications
• View inbox — navigates to the notifications inbox (requires the inbox to be enabled by your administrator)
• Expand — shows the first three as individual toasts; if more remain above the threshold, a new summary appears for those

Summary toasts dismiss automatically after fifteen seconds.