artifacts.space/Docs
Sign in

Get started

  • Introduction
  • Quickstart
  • Client setup

Reference

  • MCP reference
  • Formats
  • Themes

Work together

  • Sharing, teams, and agents

Run it

  • Limits and quotas
  • Self-hosting

Earlier formats

  • JSON Render
  • Components

    Layout

    • Section
    • Stack
    • Grid
    • Card
    • Tabs
    • Accordion
    • Separator
    • Box

    Content

    • Heading
    • Text
    • Markdown
    • Code
    • Callout
    • Badge
    • List
    • Steps
    • Link
    • Quote
    • Icon
    • Avatar
    • AvatarGroup
    • Kbd
    • Rating

    Data

    • Table
    • Metric
    • Chart
    • KeyValue
    • Progress
    • Timeline
    • Diagram

    Planning

    • Board
    • Calendar

    Inputs

    • Checklist
    • Checkbox
    • Select
    • Switch
    • Slider
    • Button
    • Input
    • Textarea

    Media

    • Image
    • File
    • Placeholder
  • Dynamic props and actions
  • Charts
  • Section templates
  • Validation
  • Stout guarantees
  • Playground
  • Prompting your agent
artifacts.space
DocsSourceSign inCreate accountSupportPrivacyTerms

© 2026 Webrenew LLC

Components · Data

Timeline

A vertical list of dated events with done, current, or upcoming status.

ExamplesLink to this section

Done, current, and upcoming
  1. Design agreedNov 5(done)

  2. Component setNov 6(current)

    Stout components and the gallery.

  3. File storageNov 8(upcoming)

Show JSONHide JSON
{
  "version": 1,
  "root": "timeline",
  "elements": {
    "timeline": {
      "type": "Timeline",
      "props": {
        "items": [
          {
            "title": "Design agreed",
            "time": "Nov 5",
            "status": "done"
          },
          {
            "title": "Component set",
            "time": "Nov 6",
            "status": "current",
            "description": "Stout components and the gallery."
          },
          {
            "title": "File storage",
            "time": "Nov 8",
            "status": "upcoming"
          }
        ]
      }
    }
  }
}

PropsLink to this section

Generated from the zod schema the server validates with. Unknown props are ignored with a warning. Any prop can also be a dynamic value such as { "$state": "/path" }; it is checked again once it resolves.

PropTypeLimits and defaults
itemsrequiredobject[]max 100 items
items[].titlerequiredstringmax 160 chars
items[].timestringmax 60 chars
items[].descriptionstringmax 1,000 chars
items[].status"done" | "current" | "upcoming"—

Children and eventsLink to this section

Timeline is a leaf: it does not show children. Validation warns when a leaf has some; wrap them in a Stack or Card instead.

It emits no events.

Edit this page on GitHub
PreviousProgressNextDiagram

On this page

  • Examples
  • Props
  • Children and events