On this page
@addTagHelper *, Webority.Ui.RazorGrouped by day, with read state
Choosing an item marks it read, and Mark all read clears the rest so the count and the bell follow.
Read state in your hands
Items grouped by day, with a live count.
Tabs
Tabs split the list into All, Unread and Archived, so a person can see only the items they are working on.
All, Unread and Archived
The three tabs over one list.
Notifications
You are all caught up.
Nothing new
With no items the panel says so, and when every item is read the badge goes and Mark all read is disabled.
Empty
The panel with no items and its empty text.
Notifications
You are all caught up.
Every option
Every value of every prop, one cell each.
items: the list, newest first
items: mixed days
items: all read
Notifications
items: empty list
Notifications
You are all caught up.
id and title: the row's identity
id: not drawn, names the row to your script
Notifications
Today
title: the one line that says what happened
Notifications
Today
text: the second line
text: (default), no second line
Notifications
Yesterday
text="By Meera Iyer": a quieter second line
Notifications
Today
href: the record it opens
href: (default), no link, the row is a button
Notifications
Yesterday
href="#invoice-2041": the row is a link
Notifications
at: the time
at: an ISO date-time with its zone
Notifications
Today
at: a YYYY-MM-DD day
Notifications
10-Oct-2026
read: the unread dot
read: (default), unread, with its dot
Notifications
Today
read="true": no dot, regular weight
Notifications
Today
archived: filed away
archived: (default), not filed away
archived="true": shown only under the Archived tab
Notifications
You are all caught up.
icon: a library icon name
icon: (default), no glyph
Notifications
Yesterday
icon="receipt": drawn before the text
Notifications
Today
unread: the badge count
unread: (default), the unread items
unread="120": a count larger than the list
label: the bell and the heading
label="Notifications" (default)
label="Alerts"
emptyText: when there are no items
empty-text="You are all caught up." (default)
Notifications
You are all caught up.
empty-text="Nothing waiting for you"
Notifications
Nothing waiting for you
viewAllHref: the link under the list
view-all-href: (default), no link
view-all-href="#all": a View all link
defaultOpen: open at first paint
open: (default), closed
open="true": open at first paint
now: the clock for Today and Yesterday
now: (default), the current time
now="2026-10-11T14:30:00+05:30": a fixed clock
Notifications
Today
Yesterday
onMarkAllRead: Mark all read (read-action on Razor)
read-action: (default), no button
read-action="?handler=ReadAll": POSTs the unread ids, succeeds
read-action="?handler=Fail": the server refuses the POST
onMarkAllRead: React only, a callback
onItemClick: an item is chosen
onItemClick: React only, a callback; the link is followed
renderItem: the row's own content
renderItem: (default), the standard row
renderItem: React only, a custom row
tabs: the tab strip
tabs: (default), no tab strip
tabs="true": All, Unread and Archived
Notifications
You are all caught up.
tabs="unread,archived:Filed"
Notifications
You are all caught up.
onTabChange: a tab is picked
onTabChange: React only, a callback
Notifications
You are all caught up.
onOpenChange: the panel opens or closes
onOpenChange: React only, a callback
linkComponent: a router link
linkComponent: React only, Razor links are plain hrefs
className: the root's extra class
class: the root's own class, the Razor form of className
Guidance
What to do, and what to avoid.
Use it when
- A portal's list of things that happened to the person: approvals, comments, runs finished.
- Anything that links to a record.
- A row needs its own controls, such as Accept and Decline buttons: pass renderItem(item), which returns the row's content in place of the icon, title, text and time. The dot, the Unread prefix and the read handling stay.
- A product brands the unread count: set --wui-notification-count-bg (the fill, default the strong danger colour) and --wui-notification-count-fg (the text, default white) on .wui-notification-center or an ancestor. No prop or class override is needed.
Reach for something else when
- A message that must be acted on right now. → AppAlert or AppToast
- The shell's topbar bell fed by a server fragment. → AppShell notifications
Reference
Try every prop, read the full list, and check keyboard and screen reader behaviour.
8 props. The 4 most used come first.
Used on most screens 4 props
| Prop | Type | Default | Description |
|---|---|---|---|
| unreaddefault - | int | - | The badge count when it is larger than the items listed, for example the latest twenty of 120. Without it the count is the number of unread items. |
| labeldefault Notifications | string | Notifications | The bell's name and the panel heading. |
| empty-textdefault You are all caught up. | string | You are all caught up. | Shown when there are no items. |
| view-all-hrefdefault - | string | - | A View all link under the list. Without it there is no link. |
Less common 4 props
| Prop | Type | Default | Description |
|---|---|---|---|
| read-actiondefault - | string | - | Where Mark all read POSTs the unread ids, repeated as ids, with the antiforgery token. Without it there is no button. |
| opendefault false | bool | false | Start with the panel open; the browser owns it after that. |
| nowdefault - | string | - | The clock for Today and Yesterday, as ISO text or epoch milliseconds. The current time when omitted. |
| tabsdefault - | string | - | true for the tabs All, Unread and Archived, or a comma list of keys in order, each optionally key:Label. Without it there is no tab strip. |
8 props.
Less common 8 props
| Prop | Type | Default | Description |
|---|---|---|---|
| iddefault - | string | - | Stable id; names the notification to your script and to the server. Required. |
| titledefault - | string | - | The one line that says what happened. Required. |
| textdefault - | string | - | A second, quieter line. |
| hrefdefault - | string | - | The record it opens. Without it the notification is a button. |
| atdefault - | string | - | When it happened: an ISO date-time with its zone, or a YYYY-MM-DD day. Required. |
| readdefault false | bool | false | Already read: no dot, regular weight. |
| icondefault - | string | - | A library icon name, drawn before the text. |
| archiveddefault false | bool | false | Filed away: shown only under the Archived tab. |
Screen reader
3 notes- The bell is a button with aria-haspopup dialog and aria-expanded, named with the label and the unread count.
- The panel is a dialog named by its heading; Escape closes it and returns focus to the bell.
- A change in the unread count is announced through a polite live region, and each unread item carries a visually hidden Unread prefix.