On this page
@addTagHelper *, Webority.Ui.RazorActivity feed
Use a feed for an audit trail of what happened, when, and who did it.
- Report approved
- Submitted for sign-off
- Approved
- Rejected
- Overdue
- Reminder sent
- Draft created
- Report approved
- Submitted for sign-off
- Returned for revision
Zone 3 lightning density looks off against the site coordinates. Please re-check before resubmitting.
- Draft created
- Draft created
- Draft created
Progress tracker
Show where a fixed sequence of stages stands, so people see what is done and what is next.
- Initiated25 Jul 2026Loan application process started
- Approved / Rejected
- Sanctioned
- Initiated25 Jul 2026Loan application process started
- Approved / Rejected
- Sanctioned
- Upcomingstatus="upcoming"Not started yet: a future step.
- In progressstatus="current"Being worked on right now.
- Completedstatus="done"Finished successfully.
- On holdstatus="on-hold"Blocked, waiting on an external action.
- Rejectedstatus="rejected"Declined or failed: a terminal error.
- Cancelledstatus="cancelled"Aborted because the plan changed.
- Skippedstatus="skipped"Intentionally bypassed.
Numbered steps
Number the stages of a process so a person can follow it from the first step to the last.
- Step 1Assess the riskWork out how likely lightning is to harm a building, and what protection it needs.
- Step 2Set up the protectionOnce the report is issued, record the protection and its test points.
- Step 3Inspect it regularlyCheck the protection still works, on the dates you set.
- Step 1Assess the riskWork out how likely lightning is to harm a building, and what protection it needs.
- Step 2Set up the protectionOnce the report is issued, record the protection and its test points.
- Step 3Inspect it regularlyCheck the protection still works, on the dates you set.
- Phase AAssess the risk
- Phase BSet up the protection
Sizes
Pick a larger dot for a headline timeline and a smaller one where the list is dense.
- Report approved
- Submitted for sign-off
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.
- Report approved
Signed off by **Priya Sharma**.
Checked: - the totals - the *GST* line
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.
- Averyveryverylongsingletokenstitlethatmustwrapinsteadofoverflowingthetimelinerail
- No icon given
- No status given25 Jul 2026
Every option
Every value of every prop, one cell each.
variant
(default): variant="feed"
- Draft created
variant="progress"
- Initiated25 Jul 2026Loan application process started
- Approved / Rejected
variant="steps"
- Step 1Assess the riskWork out how likely lightning is to harm a building, and what protection it needs.
- Step 2Set up the protectionOnce the report is issued, record the protection and its test points.
orientation
orientation="vertical"
- Initiated25 Jul 2026Loan application process started
- Approved / Rejected
- Sanctioned
orientation="horizontal"
- Initiated25 Jul 2026Loan application process started
- Approved / Rejected
- Sanctioned
size
size="sm"
- Report approved
(default): size="md"
- Report approved
size="lg"
- Report approved
size="20"
- Report approved
size="24"
- Report approved
size="32"
- Report approved
size="44"
- Report approved
icon variant
(default): icon-variant="linear"
- Report approved
icon-variant="outline"
- Report approved
icon-variant="bold"
- Report approved
icon-variant="bulk"
- Report approved
icon-variant="broken"
- Report approved
icon-variant="twotone"
- Report approved
items: title
title: plain text
- Submitted
title: a string only, so no bold markup
- Approved, final
items: tone
(default): tone="neutral"
- Draft created
tone="success"
- Event success
tone="warning"
- Event warning
tone="danger"
- Event danger
tone="info"
- Event info
items: icon
(default): circle
- No icon given
icon="send"
- Submitted
items: eyebrow
(default): Step 1, Step 2
- Step 1Assess the risk
- Step 2Set up the protection
eyebrow="Phase A"
- Phase AAssess the risk
eyebrow="" hides the label
- Assess the risk
items: at, time and by
neither at nor by
- Draft created
at only
- Draft created
at and time
- Draft created
by only
- Draft created
at, time and by
- Draft created
at-title: full date on hover
- Draft created
items: byHref
by as plain text
- Draft created
by-href: by linked to a page
- Draft created
items: note
no note
- Submitted for sign-off
with a note
- Returned for revision
Zone 3 lightning density looks off against the site coordinates.
items: description
no description
- Submitted
with a description
- SubmittedFile shared with the lender.
items: status
status="upcoming"
- UpcomingNot started yet: a future step.
status="current"
- In progressBeing worked on right now.
status="done"
- CompletedFinished successfully.
status="on-hold"
- On holdBlocked, waiting on an external action.
status="rejected"
- RejectedDeclined or failed: a terminal error.
status="cancelled"
- CancelledAborted because the plan changed.
status="skipped"
- SkippedIntentionally bypassed.
items: key
key: React only, Razor items have no key
- Draft created
items: empty list
no app-timeline-item children: an empty list, still a valid list
step label
(default): step-label="Step {number}"
- Step 1Assess the riskWork out how likely lightning is to harm a building, and what protection it needs.
- Step 2Set up the protectionOnce the report is issued, record the protection and its test points.
step-label="Stage {number}"
- Stage 1Assess the riskWork out how likely lightning is to harm a building, and what protection it needs.
- Stage 2Set up the protectionOnce the report is issued, record the protection and its test points.
linkComponent
linkComponent: React only, Razor uses a plain href
- Draft created
className
class="timeline-demo": a class added to the list
- Draft created
markdown
(default): no markdown attribute
- SubmittedSigned off by **Priya Sharma**.
markdown="true"
- 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
- Report approved
Title in the past tense saying what happened, plus the actor and an absolute timestamp: the three things an audit reader is looking for.
- Status changed
'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.
18 props. The 4 most used come first.
Used on most screens 4 props
| Prop | Type | Default | Description |
|---|---|---|---|
| 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
| Prop | Type | Default | Description |
|---|---|---|---|
| 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 pairsRecord what happened, by whom, when
- Report approved
Title in the past tense saying what happened, plus the actor and an absolute timestamp: the three things an audit reader is looking for.
- Status changed
'Status changed' to what, by whom? And '2 days ago' cannot be cross-referenced against anything, so an audit trail needs absolute times.