About this block

Notification Grouping List is the smart inbox panel, notifications folded by source so the list stays readable. Maya Chen commented 3 times on Q3 launch plan with all three messages visible inline (the onboarding funnel, the pricing tier names, the flag to Noah), while 4 CI deploys to api, web, worker, and cron collapse to one summary row. Unread rows carry a foreground dot and a count badge; read rows fade the avatar to 60 percent.

Items are one typed union array splitting single and group shapes; every field is present on both, unset fields carry undefined rather than being omitted. The expanded inline thread is what makes grouping feel like reading, not hiding.

When to use

Reach for this block on a dedicated notifications or inbox page, wired to your notifications endpoint with grouping keyed on actor and thread id. Keep the unread count in the page title or shell badge consistent with what the panel shows.

A natural flow around it on an Application Pro page:

Before

• App shell

After

• Snooze options
• Banner with actions

What you can display

One strong use is the team collaboration inbox. Other grouped lists:

• CI and deploy feed. Pipeline events collapsed by run, expanded to show each job.
• Comment threads. Document comments grouped by document, expanded to show the thread.
• Mention digest. All mentions across channels collapsed to one row per channel.

Tip: show the count badge on the collapsed row so users know what they are hiding before they expand.