Skip to content
Razor catalogue

On this page

@addTagHelper *, Webority.Ui.Razor

Activity feed

Use a feed for an audit trail of what happened, when, and who did it.

Feed basics
  1. Report approved
    24-Jul-202614:05Priya Sharma
  2. Submitted for sign-off
    24-Jul-202611:20Ravi Kumar
Show code
<app-timeline>
    <app-timeline-item tone="StatusTone.Success" icon="check-circle" title="Report approved" at="24-Jul-2026" time="14:05" by="Priya Sharma" />
    <app-timeline-item icon="send" title="Submitted for sign-off" at="24-Jul-2026" time="11:20" by="Ravi Kumar" />
</app-timeline>
Tones
  1. Approved
    14:05
  2. Rejected
    13:40
  3. Overdue
    12:00
  4. Reminder sent
    11:30
  5. Draft created
    09:15
Show code
<app-timeline>
    <app-timeline-item tone="StatusTone.Success" icon="check-circle" title="Approved" at="14:05" />
    <app-timeline-item tone="StatusTone.Danger" icon="alert-circle" title="Rejected" at="13:40" />
    <app-timeline-item tone="StatusTone.Warning" icon="alert-triangle" title="Overdue" at="12:00" />
    <app-timeline-item tone="StatusTone.Info" icon="info" title="Reminder sent" at="11:30" />
    <app-timeline-item title="Draft created" at="09:15" />
</app-timeline>
Notes
  1. Report approved
    24-Jul-202614:05Priya Sharma
  2. Submitted for sign-off
    24-Jul-202611:20Ravi Kumar
  3. Returned for revision
    22-Jul-202616:42Priya Sharma

    Zone 3 lightning density looks off against the site coordinates. Please re-check before resubmitting.

  4. Draft created
    21-Jul-202609:15Ravi Kumar
Show code
<app-timeline>
    <app-timeline-item tone="StatusTone.Success" icon="check-circle" title="Report approved" at="24-Jul-2026" time="14:05" by="Priya Sharma" />
    <app-timeline-item icon="send" title="Submitted for sign-off" at="24-Jul-2026" time="11:20" by="Ravi Kumar" />
    <app-timeline-item tone="StatusTone.Danger" icon="alert-circle" title="Returned for revision" at="22-Jul-2026" time="16:42" by="Priya Sharma"
        note="Zone 3 lightning density looks off against the site coordinates. Please re-check before resubmitting." />
    <app-timeline-item icon="file-plus-2" title="Draft created" at="21-Jul-2026" time="09:15" by="Ravi Kumar" />
</app-timeline>
Feed · full date on hover
  1. Draft created
    2 hours agoRavi Kumar
Show code
<app-timeline>
    <app-timeline-item icon="file-plus-2" title="Draft created" at="2 hours ago" at-title="14 Oct 2026, 4:05 pm" by="Ravi Kumar" />
</app-timeline>
Feed · by linked to a profile
  1. Draft created
Show code
<app-timeline>
    <app-timeline-item icon="file-plus-2" title="Draft created" by="Ravi Kumar" by-href="/people/ravi-kumar" />
</app-timeline>

Progress tracker

Show where a fixed sequence of stages stands, so people see what is done and what is next.

Status tracker
  1. Initiated
    25 Jul 2026
    Loan application process started
  2. Approved / Rejected
  3. Sanctioned
Show code
<app-timeline variant="Progress">
    <app-timeline-item status="AppTimelineItemStatus.Done" title="Initiated" description="Loan application process started" at="25 Jul 2026" />
    <app-timeline-item status="AppTimelineItemStatus.Current" title="Approved / Rejected" />
    <app-timeline-item status="AppTimelineItemStatus.Upcoming" title="Sanctioned" />
</app-timeline>
Horizontal tracker
  1. Initiated
    25 Jul 2026
    Loan application process started
  2. Approved / Rejected
  3. Sanctioned
Show code
<app-timeline variant="Progress" orientation="Orientation.Horizontal">
    <app-timeline-item status="AppTimelineItemStatus.Done" title="Initiated" description="Loan application process started" at="25 Jul 2026" />
    <app-timeline-item status="AppTimelineItemStatus.Current" title="Approved / Rejected" />
    <app-timeline-item status="AppTimelineItemStatus.Upcoming" title="Sanctioned" />
</app-timeline>
Status words
  1. Upcoming
    status="upcoming"
    Not started yet: a future step.
  2. In progress
    status="current"
    Being worked on right now.
  3. Completed
    status="done"
    Finished successfully.
  4. On hold
    status="on-hold"
    Blocked, waiting on an external action.
  5. Rejected
    status="rejected"
    Declined or failed: a terminal error.
  6. Cancelled
    status="cancelled"
    Aborted because the plan changed.
  7. Skipped
    status="skipped"
    Intentionally bypassed.
Show code
<app-timeline variant="Progress">
    <app-timeline-item status="AppTimelineItemStatus.Upcoming" title="Upcoming" description="Not started yet: a future step." />
    <app-timeline-item status="AppTimelineItemStatus.Current" title="In progress" description="Being worked on right now." />
    <app-timeline-item status="AppTimelineItemStatus.Done" title="Completed" description="Finished successfully." />
    <app-timeline-item status="AppTimelineItemStatus.OnHold" title="On hold" description="Blocked, waiting on an external action." />
    <app-timeline-item status="AppTimelineItemStatus.Rejected" title="Rejected" description="Declined or failed: a terminal error." />
    <app-timeline-item status="AppTimelineItemStatus.Cancelled" title="Cancelled" description="Aborted because the plan changed." />
    <app-timeline-item status="AppTimelineItemStatus.Skipped" title="Skipped" description="Intentionally bypassed." />
</app-timeline>

Numbered steps

Number the stages of a process so a person can follow it from the first step to the last.

Steps
  1. Step 1
    Assess the risk
    Work out how likely lightning is to harm a building, and what protection it needs.
  2. Step 2
    Set up the protection
    Once the report is issued, record the protection and its test points.
  3. Step 3
    Inspect it regularly
    Check the protection still works, on the dates you set.
Show code
<app-timeline variant="Steps">
    <app-timeline-item icon="search-normal" tone="StatusTone.Info" title="Assess the risk" description="Work out how likely lightning is to harm a building, and what protection it needs." />
    <app-timeline-item icon="shield-tick" tone="StatusTone.Success" title="Set up the protection" description="Once the report is issued, record the protection and its test points." />
    <app-timeline-item icon="clipboard-tick" tone="StatusTone.Warning" title="Inspect it regularly" description="Check the protection still works, on the dates you set." />
</app-timeline>
Small steps
  1. Step 1
    Assess the risk
    Work out how likely lightning is to harm a building, and what protection it needs.
  2. Step 2
    Set up the protection
    Once the report is issued, record the protection and its test points.
  3. Step 3
    Inspect it regularly
    Check the protection still works, on the dates you set.
Show code
<app-timeline variant="Steps" size="ControlSize.Sm">
    <app-timeline-item icon="search-normal" tone="StatusTone.Info" title="Assess the risk" description="Work out how likely lightning is to harm a building, and what protection it needs." />
    <app-timeline-item icon="shield-tick" tone="StatusTone.Success" title="Set up the protection" description="Once the report is issued, record the protection and its test points." />
    <app-timeline-item icon="clipboard-tick" tone="StatusTone.Warning" title="Inspect it regularly" description="Check the protection still works, on the dates you set." />
</app-timeline>
Custom labels
eyebrow replaces the Step 1, Step 2 default on an item. An empty value hides the label.
  1. Phase A
    Assess the risk
  2. Phase B
    Set up the protection
Show code
<app-timeline variant="Steps">
    <app-timeline-item eyebrow="Phase A" icon="search-normal" tone="StatusTone.Info" title="Assess the risk" />
    <app-timeline-item eyebrow="Phase B" icon="shield-tick" tone="StatusTone.Success" title="Set up the protection" />
</app-timeline>

Sizes

Pick a larger dot for a headline timeline and a smaller one where the list is dense.

Large and small dots
  1. Report approved
    24-Jul-202614:05Priya Sharma
  1. Submitted for sign-off
    24-Jul-202611:20Ravi Kumar
Show code
<app-timeline size-px="32">
    <app-timeline-item tone="StatusTone.Success" icon="check-circle" title="Report approved" at="24-Jul-2026" time="14:05" by="Priya Sharma" />
</app-timeline>
<app-timeline size="ControlSize.Sm">
    <app-timeline-item icon="send" title="Submitted for sign-off" at="24-Jul-2026" time="11:20" by="Ravi Kumar" />
</app-timeline>

Markdown text

Set markdown to draw the description and the note as Markdown, so text a person typed with bold, lists or links reads formatted.

Markdown description and note
  1. Report approved
    Signed off by **Priya Sharma**.
    24-Jul-202614:05Priya Sharma
    Checked:
    
    - the totals
    - the *GST* line
Show code
<app-timeline markdown="true">
    <app-timeline-item tone="StatusTone.Success" icon="check-circle" title="Report approved" at="24-Jul-2026" time="14:05" by="Priya Sharma"
        description="Signed off by **Priya Sharma**." note="Checked:\n\n- the totals\n- the *GST* line" />
</app-timeline>

Edge cases

Entries at their limits: a title that cannot break at a space, an entry with no icon, and a progress step with no status.

Long single-token title
A title with no space wraps inside the rail instead of pushing it wider.
  1. Averyveryverylongsingletokenstitlethatmustwrapinsteadofoverflowingthetimelinerail
    24-Jul-202614:05Priya Sharma
Show code
<app-timeline>
    <app-timeline-item tone="StatusTone.Warning" icon="alert-triangle" title="Averyveryverylongsingletokenstitlethatmustwrapinsteadofoverflowingthetimelinerail" at="24-Jul-2026" time="14:05" by="Priya Sharma" />
</app-timeline>
No icon
An entry without an icon shows the default circle.
  1. No icon given
Show code
<app-timeline>
    <app-timeline-item title="No icon given" />
</app-timeline>
No status
A progress step with no status draws an empty ring.
  1. No status given
    25 Jul 2026
Show code
<app-timeline variant="Progress">
    <app-timeline-item title="No status given" at="25 Jul 2026" />
</app-timeline>

Every option

Every value of every prop, one cell each.

variant

(default): variant="feed"
  1. Draft created
    21-Jul-2026Ravi Kumar
variant="progress"
  1. Initiated
    25 Jul 2026
    Loan application process started
  2. Approved / Rejected
variant="steps"
  1. Step 1
    Assess the risk
    Work out how likely lightning is to harm a building, and what protection it needs.
  2. Step 2
    Set up the protection
    Once the report is issued, record the protection and its test points.

orientation

orientation="vertical"
  1. Initiated
    25 Jul 2026
    Loan application process started
  2. Approved / Rejected
  3. Sanctioned
orientation="horizontal"
  1. Initiated
    25 Jul 2026
    Loan application process started
  2. Approved / Rejected
  3. Sanctioned

size

size="sm"
  1. Report approved
    24-Jul-202614:05Priya Sharma
(default): size="md"
  1. Report approved
    24-Jul-202614:05Priya Sharma
size="lg"
  1. Report approved
    24-Jul-202614:05Priya Sharma
size="20"
  1. Report approved
    24-Jul-202614:05Priya Sharma
size="24"
  1. Report approved
    24-Jul-202614:05Priya Sharma
size="32"
  1. Report approved
    24-Jul-202614:05Priya Sharma
size="44"
  1. Report approved
    24-Jul-202614:05Priya Sharma

icon variant

(default): icon-variant="linear"
  1. Report approved
icon-variant="outline"
  1. Report approved
icon-variant="bold"
  1. Report approved
icon-variant="bulk"
  1. Report approved
icon-variant="broken"
  1. Report approved
icon-variant="twotone"
  1. Report approved

items: title

title: plain text
  1. Submitted
title: a string only, so no bold markup
  1. Approved, final

items: tone

(default): tone="neutral"
  1. Draft created
tone="success"
  1. Event success
tone="warning"
  1. Event warning
tone="danger"
  1. Event danger
tone="info"
  1. Event info

items: icon

(default): circle
  1. No icon given
icon="send"
  1. Submitted

items: eyebrow

(default): Step 1, Step 2
  1. Step 1
    Assess the risk
  2. Step 2
    Set up the protection
eyebrow="Phase A"
  1. Phase A
    Assess the risk
eyebrow="" hides the label
  1. Assess the risk

items: at, time and by

neither at nor by
  1. Draft created
at only
  1. Draft created
    21-Jul-2026
at and time
  1. Draft created
    21-Jul-202609:15
by only
  1. Draft created
    Ravi Kumar
at, time and by
  1. Draft created
    21-Jul-202609:15Ravi Kumar
at-title: full date on hover
  1. Draft created
    2 hours ago

items: byHref

by as plain text
  1. Draft created
    Ravi Kumar
by-href: by linked to a page
  1. Draft created

items: note

no note
  1. Submitted for sign-off
with a note
  1. Returned for revision

    Zone 3 lightning density looks off against the site coordinates.

items: description

no description
  1. Submitted
with a description
  1. Submitted
    File shared with the lender.

items: status

status="upcoming"
  1. Upcoming
    Not started yet: a future step.
status="current"
  1. In progress
    Being worked on right now.
status="done"
  1. Completed
    Finished successfully.
status="on-hold"
  1. On hold
    Blocked, waiting on an external action.
status="rejected"
  1. Rejected
    Declined or failed: a terminal error.
status="cancelled"
  1. Cancelled
    Aborted because the plan changed.
status="skipped"
  1. Skipped
    Intentionally bypassed.

items: key

key: React only, Razor items have no key
  1. Draft created

items: empty list

no app-timeline-item children: an empty list, still a valid list

    step label

    (default): step-label="Step {number}"
    1. Step 1
      Assess the risk
      Work out how likely lightning is to harm a building, and what protection it needs.
    2. Step 2
      Set up the protection
      Once the report is issued, record the protection and its test points.
    step-label="Stage {number}"
    1. Stage 1
      Assess the risk
      Work out how likely lightning is to harm a building, and what protection it needs.
    2. Stage 2
      Set up the protection
      Once the report is issued, record the protection and its test points.

    linkComponent

    linkComponent: React only, Razor uses a plain href
    1. Draft created

    className

    class="timeline-demo": a class added to the list
    1. Draft created

    markdown

    (default): no markdown attribute
    1. Submitted
      Signed off by **Priya Sharma**.
    markdown="true"
    1. Submitted
      Signed off by **Priya Sharma**.

    Guidance

    What to do, and what to avoid.

    Use it when

    • A sequence of events or steps where the order matters.
    • Feed: an audit trail or sign-off history that shows what happened, when, and who did it.
    • Progress: a live status tracker (an order, a loan, an onboarding) with a state on every step.

    Reach for something else when

    • The rows are records to sort, filter or page through. → AppDataTable
    • It is a form wizard's position indicator with no per-step history or status. → AppStepper
    • They are label/value facts with no time or step dimension. → AppDescriptions
    • There is nothing to show yet. → AppEmptyState

    Record what happened, by whom, when

    Do
    1. Report approved
      24-Jul-202614:05Priya Sharma

    Title in the past tense saying what happened, plus the actor and an absolute timestamp: the three things an audit reader is looking for.

    Avoid
    1. Status changed
      2 days ago

    'Status changed' to what, by whom? And '2 days ago' cannot be cross-referenced against anything, so an audit trail needs absolute times.

    Reference

    Try every prop, read the full list, and check keyboard and screen reader behaviour.

    feed progress steps
    neutral success warning danger info
    (default) vertical horizontal
    (none) circle check-circle alert-circle alert-triangle info send
    (default) linear outline bold bulk broken twotone
    (default) sm md lg
    (none) 24 32 40
    1. Report approved
      24-Jul-2026 14:05Priya Sharma
    React, generated from the controls
    <AppTimeline
      items={items}
    />
    Razor, the same props
    <app-timeline-item title="Report approved" at="24-Jul-2026 14:05" by="Priya Sharma" />

    18 props. The 4 most used come first.

    Used on most screens 4 props

    PropTypeDefaultDescription
    variantdefault feed Feed | Progress | Steps feed The layout: an activity feed, a status tracker for a fixed sequence of stages, or a numbered process.
    icon-variantdefault bulk for steps, linear otherwise Linear | Outline | Bold | Bulk | Broken | Twotone bulk for steps, linear otherwise The iconsax style of the dot icons. Unset, steps use bulk and the others linear.
    orientationdefault - Vertical | Horizontal - Feed and progress: vertical or horizontal. Steps: a row from md up and a column below, where vertical keeps the column at every width.
    sizedefault md Sm | Md | Lg md A preset. The presets scale the dot, text and spacing together.

    Less common 14 props

    PropTypeDefaultDescription
    titledefault - string - The step / event label.
    statusdefault - upcoming | current | done | on-hold | rejected | cancelled | skipped - Step state in the progress variant: drives the dot colour, glyph and halo and the rail segment. See Status words.
    tonedefault neutral neutral | success | warning | danger | info neutral Tints the dot (feed variant).
    icondefault circle string circle Glyph inside the dot. Overrides the status glyph. Should say the same thing as the tone.
    descriptiondefault - string - Plain inline subtext under the title (distinct from the boxed note).
    eyebrowdefault Step 1, Step 2 string Step 1, Step 2 Steps variant only: the label above the title. Omitted, it reads Step 1, Step 2; an empty value hides it.
    step-labeldefault Step {number} string Step {number} Replaces the built-in English text, for other languages. The {number} token is the step's position, counted from 1.
    markdowndefault false bool false Draws each item's description and note as Markdown (bold, italics, lists, links, code); raw HTML shows as text. Both must then be strings. Unset, they show as plain text.
    atdefault - string - Formatted timestamp. Absolute, not relative.
    at-titledefault - string - Full date and time shown on hover over at, such as 14 Oct 2026, 4:05 pm. Omit for no tooltip.
    bydefault - string - Who did it (feed variant).
    by-hrefdefault - string - Turns the by name into a link, for example to the person's profile: a path starting with one slash, or an http:// or https:// address. Any other value (javascript:, //host, a path without a leading slash), or by-href without by, throws.
    notedefault - string - Free text boxed block. Line breaks are preserved.
    size-pxdefault - number - The size in pixels, instead of a preset.

    Screen reader

    3 notes
    • The timeline is an ordered list, with one list item per entry, so assistive technology announces the order and the count.
    • A by name with a byHref is a normal link, and byHref without by is refused.
    • The full date on hover is a title attribute on the date text, so it shows for a pointer only.

    Do and avoid

    1 pairs

    Record what happened, by whom, when

    Do
    1. Report approved
      24-Jul-202614:05Priya Sharma

    Title in the past tense saying what happened, plus the actor and an absolute timestamp: the three things an audit reader is looking for.

    Avoid
    1. Status changed
      2 days ago

    'Status changed' to what, by whom? And '2 days ago' cannot be cross-referenced against anything, so an audit trail needs absolute times.