On this page
@addTagHelper *, Webority.Ui.RazorWith a picture
Add a picture and a link to an entry when the change is easier to see than to read about.
What's new
Split view
Read a record beside its list.
See how
Nothing new yet
Show the empty text when there are no entries, so the trigger still opens a readable panel.
What's new
Nothing new yet
Every option
Every value of every prop, one cell each.
entries
no app-whats-new-entry (default)What's new
Nothing new yet
one app-whats-new-entry: date, title and bodyWhat's new
Dark mode
Switch from the profile menu.
image-src and image-alt: a picture on the entryWhat's new
Split view
Read a record beside its list.
href and link-label: a link on the entryWhat's new
Edit many rows at once
Select rows in any table.
See how
storageKey
storage-key="every-option-storage": keeps the read state under this keyWhat's new
Edit many rows at once
Select rows in any table and change a field for all of them.
See howDark mode
Switch from the profile menu. It follows your device by default.
readThrough
read-through="2026-10-04": entries up to that date count as readWhat's new
Edit many rows at once
Select rows in any table and change a field for all of them.
See howDark mode
Switch from the profile menu. It follows your device by default.
indicator
indicator="dot" (default)What's new
Edit many rows at once
Select rows in any table and change a field for all of them.
See howDark mode
Switch from the profile menu. It follows your device by default.
indicator="count"What's new
Edit many rows at once
Select rows in any table and change a field for all of them.
See howDark mode
Switch from the profile menu. It follows your device by default.
label
label="Updates": the trigger's name and the panel's headingUpdates
Edit many rows at once
Select rows in any table and change a field for all of them.
See howDark mode
Switch from the profile menu. It follows your device by default.
unreadLabel
unread-label="new": added to the trigger's name while entries are unreadWhat's new
Edit many rows at once
Select rows in any table and change a field for all of them.
See howDark mode
Switch from the profile menu. It follows your device by default.
emptyText
empty-text="All caught up": shown when there are no entriesWhat's new
All caught up
onRead
onRead: the wui-whats-new-read event, with the newest date in detail.throughWhat's new
Edit many rows at once
Select rows in any table and change a field for all of them.
See howDark mode
Switch from the profile menu. It follows your device by default.
linkComponent
linkComponent (React only): Razor has no router, so a plain href on the entryWhat's new
Edit many rows at once
Select rows in any table.
See how
className
class: the Razor form of React's className, no visible changeWhat's new
Nothing new yet
Guidance
What to do, and what to avoid.
Use it when
- Telling everyone about a feature or change since their last visit.
- A short, dated list of release notes.
Reach for something else when
- Messages addressed to the person. → The shell's notification bell
- A one-off tour of a screen. → AppTour
Reference
Try every prop, read the full list, and check keyboard and screen reader behaviour.
6 props. The 4 most used come first.
Used on most screens 4 props
| Prop | Type | Default | Description |
|---|---|---|---|
| storage-keydefault - | string | - | Names where read state is kept. Include the user's id. |
| labeldefault What's new | string | What's new | The trigger's name and the panel's heading. |
| read-throughdefault - | string | - | An ISO date or date-time read on another device or saved on the server. Entries up to the later of it and the stored read state count as read. |
| indicatordefault dot | dot | count | dot | The unread mark on the trigger: a dot, or the number of unread entries. |
Less common 2 props
| Prop | Type | Default | Description |
|---|---|---|---|
| unread-labeldefault unread | string | unread | Added to the trigger's name while there are unread entries. |
| empty-textdefault Nothing new yet | string | Nothing new yet | Shown when there are no entries. |
app-whats-new-entry
7 props.
Less common 7 props
| Prop | Type | Default | Description |
|---|---|---|---|
| datedefault - | string | - | The day it shipped, an ISO date or date-time; shown as DD-MMM-YYYY. |
| titledefault - | string | - | The entry's heading. |
| bodydefault - | string | - | A sentence or two on what changed. |
| image-srcdefault - | string | - | An optional picture, lazy-loaded. |
| image-altdefault - | string | - | Describes the picture; empty when it adds nothing. |
| hrefdefault - | string | - | Where the entry's link goes. |
| link-labeldefault Learn more | string | Learn more | The link's text. |
Screen reader
3 notes- The trigger is a native button with aria-haspopup dialog, and the element keeps its aria-expanded and aria-controls in step with the panel.
- The panel is a dialog named by label; opening it moves focus into the panel, and Escape closes it and returns focus to the trigger.
- The unread dot is hidden from assistive technology; the unread state is spoken through unreadLabel in the trigger's name.