Timelines
Timelines are chronological narrative formats—events on a date axis, each item optionally linked to pins, with layout modes for horizontal or vertical presentation.
When to use timelines
- Roadmaps & history — Product milestones, company history, release trains.
- Incident timelines — What happened when, with evidence pins per event.
- Research chronology — Order findings and sources over time.
Key features
- Timeline items — Date/label, title, description, optional pin reference.
- Layout modes — Horizontal, large horizontal, and vertical views.
- Reorder — Drag items to adjust chronology.
- Share — Public or authenticated timeline views.
How timelines relate to pins
Timeline items can reference pins for rich detail at each point in time. Pin data is maintained separately and updated via the Pins API.
Note: The
timelinepin type is a single pin with its ownpin_config.itemsarray. A Timeline format is a workspace-level container (tl…) that can hold many items and span multiple pins.
IDs & routes
- ID prefix:
tl… - Dashboard:
/timelines/[timelineId] - Share:
/share/timeline/[timelineId]
API
| Resource | Status |
|---|---|
/v1/timelines | REST (Workspace auth) |
timeline pin type | Pin Types & Schemas |
Related
- Showcases — Swipe-style highlights
- Roadmap pin · Calendar pin · Steps pin