Event timeline
Event timeline puts dated events along a spine, with a callout for each one, so you can read a sequence of milestones in order.
Follow product launch milestones
Six milestones from Idea on March 2 to Launch on March 24, 2026 sit along one spine, each with its own callout.
Event timeline interactive example
Loading interactive example…
The live example needs a desktop screen. The result it produces is shown here, and the explanation and settings below work on any screen.
| Date | Event |
|---|---|
| 2026-03-02 | Idea |
| 2026-03-05 | Sketch |
| 2026-03-10 | Prototype |
| 2026-03-16 | Test |
| 2026-03-20 | Ready |
| 2026-03-24 | Launch |
- In the Data tab, change Group dates by to a larger period to merge nearby events.
- Open the Design tab and expand Spine and markers to change the line and its marks.
- Expand Callouts and cards to change how each event is shown.
When to use
Use Event timeline for a sequence of moments where each event's name matters, such as a product's history. If the work has start and end dates, use Gantt chart to show how long each item takes.
Inputs
- Table
Accepts: Tables.
Accepts one connection on this port.
Settings
- Date
Date column for the task start, event date or calendar day. Auto picks one.
- Event
Column that names each task or event. Auto picks a readable one.
- Color by
Optional column that groups tasks or colors events.
- Group dates by
How dates in this field are grouped, such as by day, month or year. Month of year, Day of week and Hour of day aren't offered on Event timeline.
Default:
DayOptions: Exact, Second, Minute, Hour, Day, Week, Month, Quarter, Year, Month of year, Day of week, Hour of day.
34 more settings
- Period size
Number of units in each period. Hours, minutes and seconds count fixed intervals from 1970-01-01 in the chart's time zone. Calendar periods follow local boundaries.
Default:
1- Source timezone
IANA time zone for timestamps without an offset, such as Europe/Copenhagen. Ambiguous local times need an explicit offset.
Default:
UTC- Chart timezone
IANA time zone used for grouping and display. Vista filters keep their own time zone.
Default:
UTC- Week starts
Day the week starts on.
Default:
MondayOptions: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
- Fiscal year starts
Month the fiscal year starts in. Sets quarter and year boundaries.
Default:
JanuaryOptions: January, February, March, April, May, June, July, August, September, October, November, December.
- Sort by
Order of the tasks or events, chronological by default.
Default:
Default (chronological)Options: Default (chronological), Start, End, Duration, Task, Group, Rows.
- Date labels
How dates are written in the chart labels.
Default:
AutoOptions: Auto, Iso, Date, Datetime, Custom.
- Tooltip dates
How dates are written in tooltips.
Default:
IsoOptions: Auto, Iso, Date, Datetime, Custom.
- Show tooltip
Shows or hides values when you hover over a mark.
Default:
true- Tooltip
Text shown when you hover over a mark. Write it in the editor and insert values from Values.
- Values
Values you can insert into the text. Each row calculates a value from a source field or, in charts, shows a chart value, and can have its own number or date format.
- Title
Title shown inside the chart. Leave empty to hide it.
- Title color
Color of the title.
- Title size
Size of the title, in pixels.
Default:
24- Title alignment (plot)
Alignment of the title.
Default:
LeftOptions: Left, Center, Right.
- Callouts
Shows event callouts always, only where they fit or never.
Default:
AutoOptions: Auto, Show, Hide.
- Placement
Callouts above, below or alternating around the spine.
Default:
AlternateOptions: Alternate, Above, Below.
- Callout cards
Shows or hides a card behind each callout.
Default:
OffOptions: Off, On.
- Text align
Alignment of the callout text.
Default:
CenterOptions: Left, Center, Right.
- Wrap width
Width at which callout text wraps, in pixels.
Default:
140- Callout size
Size of the callout text, in pixels.
Default:
11- Callout color
Color of the callouts.
- Marker
Shape of the event markers on the spine.
Default:
DiamondOptions: Diamond, Circle, Square, Triangle, None.
- Marker size
Size of the markers, in pixels.
Default:
12- Spine width
Thickness of the spine, in pixels.
Default:
4- Leader height
Length of the lines to the callouts, as a percent of the callout area (10–100).
Default:
85- Spine color
Color of the spine. Auto uses a tint of the first event's color.
- Leader color
Color of the lines to the callouts. Auto uses each event's color.
- Axis labels
Date labels along the bottom: none, the two ends, one per event or a regular range.
Default:
RangeOptions: Range, Events, Ends, Off.
- Date unit
Spacing of the date labels when they show a range. Date format also applies to callouts and tooltips.
Default:
AutoOptions: Auto, Days, Months, Years.
- Background
Card background color. Auto follows the theme.
- Plot padding
Space between the card edge and the chart, in pixels.
Default:
0- Corner radius (px)
Corner radius in whole logical pixels.
Default:
0- Border width (px)
Border width in whole logical pixels.
Default:
0
Event timeline FAQs
- How does an event timeline place events on the same date?
- It draws one mark per date period and color category. Exact dates keep timestamp precision, and missing periods stay empty.
Chart your data. Build it in Vista.
Vista opens in your browser, with no account.