On this page
@addTagHelper *, Webority.Ui.RazorTitle & subtitle
A title alone is a plain block; a subtitle adds the count or state, and can sit on the title line.
With actions
Put page-level controls on the right of the masthead, usually the primary action for the whole screen.
Eyebrow and a leading icon
An eyebrow is a small kicker above the title, and a leading icon gives the masthead its identity.
Breadcrumbs and inline status
Breadcrumbs sit in their own row above the masthead, and a status sits inline beside the title.
A title with a badge or a link
Write the title as markup when a count, a badge or a link belongs beside the name, and keep its heading level.
Size, alignment and divider
Use a size for density, centre alignment for empty states and wizards, and a divider to separate a masthead from content.
One-row bar
A one-row bar fits a list or record screen: breadcrumbs as a prefix, the title, status and the actions.
Projects
Apollo
ActiveBill forwarding advice BFA-2026-00412
Every option
Every value of every prop, one cell each.
title
long title overflow, masthead does not break layouttitle omitted (React form: title={null})titleSlot
app-page-header-title (a count badge inside the heading)as: the heading level
as="h1" (default)as="h2"as="h3"as="h4"as="h5"as="h6"subtitle
subtitle="12 active projects"subtitlePlacement: below · inline
subtitle-placement="below" (default)subtitle-placement="inline"eyebrow
eyebrow="Workspace"tone without icon, tints only the eyebrowicon: name vs node
icon="users", resolved by nameicon="stars" (React also takes an icon node)(no icon)tone: all five (tints the icon tile and eyebrow)
tone="primary" (default)tone="success"tone="warning"tone="danger"tone="info"slots: status · breadcrumbs · actions
status onlybreadcrumbs onlyactions onlyall three togethermany actions, a pile of equal-weight buttons crowds the rowbar slots: views · tools · meta
views, saved views after the title (size bar only)Projects
tools, search and display before the actions (size bar only)Projects
meta, a short facts line (size bar only)Apollo
meta-placement: inline · below (size bar only)
meta-placement="inline" (default)Apollo
meta-placement="below"Apollo
bulk-for and bulk (size bar only)
bulk-for="projects" with a bulk slot: the bulk actions show only while that table has rows tickedProjects
size: sm · md · lg · bar
size="sm"size="md" (default)size="lg"size="bar"Projects
align: start vs center
align="start" (default)align="center"state: divider · sticky
(default)dividersticky (position: sticky, scroll a real page to see it hold)divider + stickyclass
class, extra classes on the header element (no visible effect alone)Guidance
What to do, and what to avoid.
Use it when
- A screen needs its standard title-and-actions masthead at the top.
- The page has a single primary action that applies to everything below it.
- You want a subtitle to show a count, status, or one-line description.
Reach for something else when
- You are titling a section inside the page, not the page itself. → AppCard title
- You need to switch between peer views of the page. → AppTabs
- The message is transient feedback, not a heading. → AppAlert
One primary page action
One clear title, a context subtitle, and the single page-level action on the right.
A pile of equal-weight buttons hides the primary action. Keep secondary ones in a menu.
Keep the subtitle short and useful
The subtitle carries useful state: what this is and when it changed.
A sentence-long subtitle reads as body copy, not a heading. Keep it to a phrase.
Reference
Try every prop, read the full list, and check keyboard and screen reader behaviour.
22 props. The 3 most used come first.
Used on most screens 3 props
| Prop | Type | Default | Description |
|---|---|---|---|
| titledefault - | string | - | The page title: the main heading of the masthead. |
| subtitledefault - | string | - | A secondary line under the title: a count, status, or short description. |
| eyebrowdefault - | string | - | A small kicker label above the title: the section or category. |
Less common 19 props
| Prop | Type | Default | Description |
|---|---|---|---|
| asdefault h1 | h1 | h2 | h3 | h4 | h5 | h6 | h1 | The heading element for the title. Keep one h1 per page. |
| app-page-header-titledefault - | slot | - | Replaces the title text with its markup inside the same heading. title still names the heading for assistive tech. |
| subtitle-placementdefault below | below | inline | below | Where the subtitle sits: under the title, or on the title line after it. Size bar ignores it. |
| icondefault - | string | - | Leading glyph: an icon name or a node. |
| tonedefault primary | primary | success | warning | danger | info | primary | Tints the icon tile and the eyebrow. |
| sizedefault md | sm | md | lg | bar | md | Title and spacing scale. bar is one 40px row. |
| meta-placementdefault inline | inline | below | inline | Where the meta line sits: inside the bar, or under it (size bar only). |
| bulk-fordefault - | string | - | Id of the data table whose selection swaps views and tools for its bulk bar (size bar only). Ticking rows hides views and tools and shows the bulk slot with an N selected count; the table's own toolbar bulk bar stays hidden. |
| aligndefault start | start | center | start | Centres the masthead, for empty states and wizards. |
| dividerdefault false | bool | false | A bottom border under the masthead. |
| stickydefault false | bool | false | Sticks the masthead to the top of the scroll container. |
| fold-actionsdefault false | bool | false | Folds the actions that do not fit into a More menu, keeping the solid primary action in the row while it fits (size bar only). |
| app-page-header-breadcrumbsdefault - | slot | - | A breadcrumbs row above the masthead, usually app-breadcrumbs. |
| app-page-header-statusdefault - | slot | - | An inline status pill beside the title, usually app-status-badge. |
| app-page-header-viewsdefault - | slot | - | Saved views after the title, in a bar (size bar only). |
| app-page-header-toolsdefault - | slot | - | Search, filters and display, right of the title, before the actions (size bar only). |
| app-page-header-metadefault - | slot | - | One short facts line or summary (size bar only). Its place is set by meta-placement. |
| app-page-header-bulkdefault - | slot | - | Bulk actions shown in the bar while the table named by bulk-for has rows ticked (size bar only). |
| (content)default - | markup | - | Right-aligned page-level actions, usually an app-button. Rendered as the trailing slot. |
Screen reader
3 notes- The title renders as the heading level chosen by as, and each page has one h1.
- The size bar renders a header element. Every other size renders a div.
- In the bar, the count of selected rows is announced politely as rows are ticked.
Do and avoid
2 pairsOne primary page action
One clear title, a context subtitle, and the single page-level action on the right.
A pile of equal-weight buttons hides the primary action. Keep secondary ones in a menu.
Keep the subtitle short and useful
The subtitle carries useful state: what this is and when it changed.
A sentence-long subtitle reads as body copy, not a heading. Keep it to a phrase.