Skip to content
Razor catalogue

On this page

@addTagHelper *, Webority.Ui.Razor

Title & subtitle

A title alone is a plain block; a subtitle adds the count or state, and can sit on the title line.

A bare title
A header with only a title stays a plain block.
Show code
<app-page-header title="Projects"></app-page-header>
Title and subtitle
The subtitle often shows how many items the page holds, or its current state.
Show code
<app-page-header title="Projects" subtitle="12 active projects"></app-page-header>
Subtitle on the title line
subtitle-placement="inline" sets the subtitle after the title and any status, on the same line, for a date beside a heading.
Show code
<app-page-header title="Leave calendar" subtitle="Tuesday, 27-Oct-2026" subtitle-placement="Inline"></app-page-header>

With actions

Put page-level controls on the right of the masthead, usually the primary action for the whole screen.

Title, subtitle and a primary action
When actions are present the header becomes a flex row that pushes them to the right.
Show code
<app-page-header title="Projects" subtitle="12 active projects">
    <app-button>Edit</app-button>
</app-page-header>
A record reached from a list
An app-record-pager in the actions moves to the previous or next record without going back to the list; with keys, J and K do too.
Show code
<app-page-header title="INV-2041">
    <app-page-header-status><app-status-badge tone="Warning" label="Pending"></app-status-badge></app-page-header-status>
    <app-record-pager index="12" total="47" prev-href="/Invoices/2040" next-href="/Invoices/2042"
        prev-label="Previous invoice" next-label="Next invoice" keys="true"></app-record-pager>
    <app-button>Approve</app-button>
</app-page-header>

Eyebrow and a leading icon

An eyebrow is a small kicker above the title, and a leading icon gives the masthead its identity.

Eyebrow, icon and tone
The tone tints the icon tile and the eyebrow so the masthead carries its intent.
Show code
<app-page-header eyebrow="Workspace" icon="folder" tone="Info" title="Projects" subtitle="12 active projects"></app-page-header>

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.

A count beside the title
The title keeps its heading level; the badge is part of the heading's content.
Show code
<app-page-header title="Projects" subtitle="All active work">
    <app-page-header-title>Projects <app-status-badge tone="Info" label="12"></app-status-badge></app-page-header-title>
</app-page-header>

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.

Large, with a divider
A larger masthead for a top-level dashboard, separated from the content below.
Show code
<app-page-header size="Lg" divider="true" title="Dashboard" subtitle="Everything at a glance"></app-page-header>
Centred
Centre alignment stacks the icon above a centred title, for onboarding and empty states.
Show code
<app-page-header align="center" icon="zap" title="Welcome aboard" subtitle="Let's set up your first project"></app-page-header>

One-row bar

A one-row bar fits a list or record screen: breadcrumbs as a prefix, the title, status and the actions.

A list page bar
Views sit after the title; tools and actions sit at the right. The row never wraps from md up.
Show code
<app-page-header size="Bar" title="Projects">
    <app-page-header-breadcrumbs>…</app-page-header-breadcrumbs>
    <app-page-header-views>…</app-page-header-views>
    <app-page-header-tools>…</app-page-header-tools>
    <app-button size="WideSize.Sm" left-icon="plus">New project</app-button>
</app-page-header>
A detail bar with a facts line below
meta-placement="below" puts the facts line on its own row under the bar, within the 72px detail budget.
Show code
<app-page-header size="Bar" title="Apollo" meta-placement="Below">
    <app-page-header-breadcrumbs>…</app-page-header-breadcrumbs>
    <app-page-header-status><app-status-badge tone="Success" label="Active" /></app-page-header-status>
    <app-page-header-meta>Server migration · 14 of 41 done · 6 days left</app-page-header-meta>
    <app-button size="WideSize.Sm">Edit</app-button>
</app-page-header>
Folding actions
With fold-actions, the actions that do not fit fold into More; the solid primary action stays.
Show code
<app-page-header title="Bill forwarding advice BFA-2026-00412" size="Bar" fold-actions="true">
    <app-button size="WideSize.Sm" tone="Neutral" variant="Outline">Print</app-button>
    <app-button size="WideSize.Sm" tone="Neutral" variant="Outline">Download PDF</app-button>
    <app-button size="WideSize.Sm" tone="Neutral" variant="Outline">Add a note</app-button>
    <app-button size="WideSize.Sm" tone="Neutral" variant="Outline">Return to depot</app-button>
    <app-button size="WideSize.Sm" tone="Neutral" variant="Outline">Reject</app-button>
    <app-button size="WideSize.Sm" tone="Neutral" variant="Outline">Approve</app-button>
    <app-button size="WideSize.Sm">Forward to head office</app-button>
</app-page-header>

Every option

Every value of every prop, one cell each.

title

long title overflow, masthead does not break layout
title 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 eyebrow

icon: name vs node

icon="users", resolved by name
icon="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 only
breadcrumbs only
actions only
all three together
many actions, a pile of equal-weight buttons crowds the row

bar slots: views · tools · meta

views, saved views after the title (size bar only)
tools, search and display before the actions (size bar only)
meta, a short facts line (size bar only)

meta-placement: inline · below (size bar only)

meta-placement="inline" (default)
meta-placement="below"

bulk-for and bulk (size bar only)

bulk-for="projects" with a bulk slot: the bulk actions show only while that table has rows ticked

size: sm · md · lg · bar

size="sm"
size="md" (default)
size="lg"
size="bar"

align: start vs center

align="start" (default)
align="center"

state: divider · sticky

(default)
divider
sticky (position: sticky, scroll a real page to see it hold)
divider + sticky

class

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

Do

One clear title, a context subtitle, and the single page-level action on the right.

Avoid

A pile of equal-weight buttons hides the primary action. Keep secondary ones in a menu.

Keep the subtitle short and useful

Do

The subtitle carries useful state: what this is and when it changed.

Avoid

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.

(none) folder flag people settings
primary success warning danger info
sm md lg bar
start center
inline below
below inline
React, generated from the controls
<AppPageHeader title="Projects" subtitle="12 active projects" size="sm" />
Razor, the same props
<app-page-header title="Projects" subtitle="12 active projects" size="Sm">
</app-page-header>

22 props. The 3 most used come first.

Used on most screens 3 props

PropTypeDefaultDescription
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

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

One primary page action

Do

One clear title, a context subtitle, and the single page-level action on the right.

Avoid

A pile of equal-weight buttons hides the primary action. Keep secondary ones in a menu.

Keep the subtitle short and useful

Do

The subtitle carries useful state: what this is and when it changed.

Avoid

A sentence-long subtitle reads as body copy, not a heading. Keep it to a phrase.