Skip to content
Razor catalogue

On this page

@addTagHelper *, Webority.Ui.Razor

With a picture

Add a picture and a link to an entry when the change is easier to see than to read about.

Entry with an image
Release notes live where people already are. The gift icon in the top bar carries a dot while there are entries the person has not read; opening the panel shows them, newest first, and marks everything read. Use it for features and changes a person would want to hear about, not for messages addressed to them (that is the notification bell). The newest date seen is kept in the browser under storage-key. Build the key with the user's id, or two people on one browser share it. To keep it on your server too, save the through date that the wui-whats-new-read event carries and pass only newer entries.
Show code
<app-whats-new storage-key="whats-new:42">
  <app-whats-new-entry date="2026-10-04" title="Split view" body="Read a record beside its list." image-src="/img/split-view.webp" image-alt="A list beside a reading pane" href="#split-view" link-label="See how"></app-whats-new-entry>
</app-whats-new>

Nothing new yet

Show the empty text when there are no entries, so the trigger still opens a readable panel.

No entries
Show code
<app-whats-new></app-whats-new>

Every option

Every value of every prop, one cell each.

entries

no app-whats-new-entry (default)
one app-whats-new-entry: date, title and body
image-src and image-alt: a picture on the entry
href and link-label: a link on the entry

storageKey

storage-key="every-option-storage": keeps the read state under this key

readThrough

read-through="2026-10-04": entries up to that date count as read

indicator

indicator="dot" (default)
indicator="count"

label

label="Updates": the trigger's name and the panel's heading

unreadLabel

unread-label="new": added to the trigger's name while entries are unread

emptyText

empty-text="All caught up": shown when there are no entries

onRead

onRead: the wui-whats-new-read event, with the newest date in detail.through

linkComponent

linkComponent (React only): Razor has no router, so a plain href on the entry

className

class: the Razor form of React's className, no visible change

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.

dot count
Two releases None yet
React, generated from the controls
<AppWhatsNew
  storageKey={`whats-new:${user.id}`}
  entries={[
    { id: "bulk-edit", date: "2026-10-04", title: "Edit many rows at once", body: "Select rows in any table…", href: "/notes/bulk-edit" },
  ]}
  onRead={(through) => saveLastRead(through)}
/>
Razor, the same props
<app-whats-new storage-key="sandbox-whats-new">
  <app-whats-new-entry date="2026-10-04" title="Edit many rows at once" body="Select rows in any table and change a field for all of them." href="#bulk-edit" link-label="See how"></app-whats-new-entry>
  <app-whats-new-entry date="2026-09-15" title="Dark mode" body="Switch from the profile menu. It follows your device by default."></app-whats-new-entry>
</app-whats-new>

6 props. The 4 most used come first.

Used on most screens 4 props

PropTypeDefaultDescription
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

PropTypeDefaultDescription
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

PropTypeDefaultDescription
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.