Font Awesome Build Awesome
Search ⌘KCtrl+K
Light Dark System Docs Color Scheme: System \ Default Awesome Shoelace Active Brutalist Glossy Matter Mellow Playful Premium Tailspin Docs Theme: Default Icon Style: Classic Regular
Solid Regular Light Thin Classic Sharp Duotone Sharp Duotone
Docs Most styles require Font Awesome Pro.
Server-Side Rendering: Off Server-Side Rendering Docs
View on GitHub
Start Components Docs Help Pro
Login Log into your account
Web Awesome Font Awesome Build Awesome
Search this site… /
Light Dark System Docs Color Scheme: System \ Default Awesome Shoelace Active Brutalist Glossy Matter Mellow Playful Premium Tailspin Docs Theme: Default Icon Style: Classic Regular
Solid Regular Light Thin Classic Sharp Duotone Sharp Duotone
Docs Most styles require Font Awesome Pro.
Server-Side Rendering: Off Server-Side Rendering Docs
View on GitHub
Components Pro

Getting Started

  • Installation
  • Usage
  • Forms
  • Localization
  • Frameworks
  • Using with AI
  • Figma Design Kit ProThis requires access to Web Awesome Pro
  • Server Rendering

Resources

  • Accessibility
  • Browser Support
  • Contributing
  • Patterns ProPatterns require access to Web Awesome Pro
  • Migrating from Shoelace
  • Visual Tests
  • Changelog
  • Help & Support

Theming & Utilities

  • Overview
  • Built-in Themes
  • Color Palettes
  • Design Tokens
  • Customizing & Theming
  • CSS Utilities

Actions

  • Button
  • Button Group
  • Copy Button
  • Dropdown
    • Dropdown Item

Forms

  • Checkbox
  • Checkbox Group
  • Color Picker
  • Combobox ProThis requires access to Web Awesome Pro
  • Date Input ProThis requires access to Web Awesome Pro
  • Date Picker ProThis requires access to Web Awesome Pro
  • File Input ProThis requires access to Web Awesome Pro
  • Input
  • Known Date
  • Number Input
  • OTP Input
  • Radio Group
    • Radio
  • Rating
  • Rich Text Editor ProThis requires access to Web Awesome Pro
  • Select
    • Option
  • Slider
  • Switch
  • Tag Input
  • Textarea
  • Time Input

Layout

  • Accordion
    • Accordion Item
  • Card
  • Details
  • Dialog
  • Divider
  • Drawer
  • Page
  • Scroller
  • Split Panel
  • Timeline
    • Timeline Item

Navigation

  • Breadcrumb
    • Breadcrumb Item
  • Pagination
  • Stepper
    • Step
  • Tab Group
    • Tab
    • Tab Panel
  • Tree
    • Tree Item

Feedback

  • Badge
  • Callout
  • Progress Bar
  • Progress Ring
  • Skeleton
  • Spinner
  • Tag
  • Toast
    • Toast Item
  • Tooltip

Media

  • Animated Image
  • Avatar
  • Carousel
    • Carousel Item
  • Code Highlighter
  • Comparison
  • Icon
  • Lightbox
    • Lightbox Item
  • Markdown
  • QR Code
  • Video ProThis requires access to Web Awesome Pro
  • Video Playlist ProThis requires access to Web Awesome Pro
  • Zoomable Frame

Data Viz ProThis requires access to Web Awesome Pro

  • Bar Chart
  • Bubble Chart
  • Data Grid
  • Doughnut Chart
  • Line Chart
  • Pie Chart
  • Polar Area Chart
  • Radar Chart
  • Scatter Chart
  • Sparkline
  • Advanced Usage

Helpers

  • Animation
  • Counter
  • Format Bytes
  • Format Date
  • Format Number
  • Include
  • Intersection Observer
  • Mutation Observer
  • Number Ticker
  • Popover
  • Popup
  • Random Content
  • Relative Time
  • Resize Observer

Timeline Item

  • API
  • Importing
  • Slots
  • Attributes & Properties
  • CSS Custom Properties
  • CSS Parts
  • SSR
On This Page...
  • API
  • Importing
  • Slots
  • Attributes & Properties
  • CSS Custom Properties
  • CSS Parts
  • SSR

Timeline Item

<wa-timeline-item>
Experimental Layout Since 3.16

Timeline items represent a single entry inside a <wa-timeline>, such as one event in an order history or activity feed.

This component must be used as a child of <wa-timeline>. Please see the Timeline docs to see examples of this component in action.

Order placed

We received your order and will begin processing it shortly.

Out for delivery
<wa-timeline>
  <wa-timeline-item data-anatomy-subject="true">
    <wa-format-date slot="opposite" date="2026-07-22T09:00:00" month="short" day="numeric"></wa-format-date>
    <span class="wa-heading-m">Order placed</span>
    <p>We received your order and will begin processing it shortly.</p>
  </wa-timeline-item>
  <wa-timeline-item>
    <wa-format-date slot="opposite" date="2026-07-24T09:00:00" month="short" day="numeric"></wa-format-date>
    <span class="wa-heading-m">Out for delivery</span>
  </wa-timeline-item>
</wa-timeline>

API

Link to This Section

Importing

Link to This Section

If you're using the autoloader or a hosted project, components load on demand — no manual import needed. To cherry-pick a component manually, use one of the following snippets.

CDN npm Self-Hosted React

Import this component directly from the CDN:

import 'https://ka-f.webawesome.com/[email protected]/components/timeline-item/timeline-item.js';

After installing Web Awesome via npm, import this component:

import '@awesome.me/webawesome/dist/components/timeline-item/timeline-item.js';

If you're self-hosting Web Awesome, import this component from your server:

import './webawesome/dist/components/timeline-item/timeline-item.js';

To import this component for React 18 or below, use the following code:

import WaTimelineItem from '@awesome.me/webawesome/dist/react/timeline-item/index.js';

Slots

Link to This Section

Learn more about using slots.

Name Description
(default) The item's main content, such as a title and description.
icon An element, such as <wa-icon> or <wa-avatar>, shown inside the marker. Icons are drawn at 40% of the marker's size, and an avatar fills the marker.
opposite Optional content shown on the opposite side of the rail from the main content, commonly a date or timestamp, such as a <wa-format-date> or <wa-relative-time>.

Attributes & Properties

Link to This Section

Learn more about attributes and properties.

Name Description Reflects
variant
variant
Colors the item's marker. Neutral items keep a quiet marker, so a variant stands out against them. The color is cosmetic; pair it with an icon and a clear label when an entry needs to read as failed or flagged.
Type 'neutral' | 'brand' | 'success' | 'warning' | 'danger'
Default 'neutral'
withIcon
with-icon
Only required for SSR. Set to true if you're slotting in an icon element, so the server-rendered markup sizes the marker for it before the component hydrates on the client.
Type boolean
Default false
withOpposite
with-opposite
Only required for SSR. Set to true if you're slotting in an opposite element, so the server-rendered markup includes it before the component hydrates on the client.
Type boolean
Default false

CSS Custom Properties

Link to This Section

Learn more about CSS custom properties.

Name Description
--connector-gap
The gap between this item's marker and its connector. Inherited from <wa-timeline>; set it here to change it for one item. Use a length such as 0px, not a bare 0, to remove it.
--icon-marker-size
The size of the item's marker when its icon slot has content, such as an icon or avatar. Inherited from <wa-timeline>, where it defaults to 2em; set it here to change it for one item.
--marker-size
The size of the item's marker when its icon slot is empty. Inherited from <wa-timeline>, where it defaults to 1em; set it here to change it for one item.

CSS Parts

Link to This Section

Learn more about CSS parts.

Name Description CSS selector
connector The line connecting this item to its neighbors. Each item draws the half leading in and the half leading out, and both carry this part name. ::part(connector)
content The wrapper around the default slot. ::part(content)
marker The circular marker that marks the item's position on the timeline. ::part(marker)
opposite The wrapper around the opposite slot. ::part(opposite)
timeline-item The component's outer wrapper. ::part(timeline-item)

SSR

Link to This Section

Learn more about Server-Side Rendering (SSR).

If you slot content into opposite, set the with-opposite attribute, otherwise the opposite column won't render until the item hydrates on the client. Likewise, if you slot content into icon, set the with-icon attribute, otherwise the marker draws at its smaller default size until the item hydrates.

Need a hand? Report a bug Ask for help
Go Make Something Awesome
Version 3.15.0 © Fonticons, Inc.
  • Terms
  • Privacy
  • Refunds
  • Core License
  • Pro License

Quick Links

  • Components
  • CSS Utilities
  • Theming
  • Using with AI
  • Changelog
  • Help & Support

Recent Searches

    D'oh! No results for “”

    Suggest on GitHub Ask on Discord
    Navigate Select
    Close Esc

    We Have Cookies…

    We use cookies to make webawesome.com work better by storing limited information about your usage.

    We value your privacy, so we won't use them for evil or ask you to join the dark side.

    Customize
    Necessary Only Accept All
    Strictly Necessary
    Required to make the site function correctly — cannot be turned off
    Functionality Analytics
    Cancel Confirm Cookie Choices