Documentation

    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.

    The live example needs a desktop screen. The result it produces is shown here, and the explanation and settings below work on any screen.

    Result
    DateEvent
    2026-03-02Idea
    2026-03-05Sketch
    2026-03-10Prototype
    2026-03-16Test
    2026-03-20Ready
    2026-03-24Launch
    1. In the Data tab, change Group dates by to a larger period to merge nearby events.
    2. Open the Design tab and expand Spine and markers to change the line and its marks.
    3. 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

    1 port
    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: Day

    Options: 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: Monday

    Options: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.

    Fiscal year starts

    Month the fiscal year starts in. Sets quarter and year boundaries.

    Default: January

    Options: 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: Auto

    Options: Auto, Iso, Date, Datetime, Custom.

    Tooltip dates

    How dates are written in tooltips.

    Default: Iso

    Options: 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: Left

    Options: Left, Center, Right.

    Callouts

    Shows event callouts always, only where they fit or never.

    Default: Auto

    Options: Auto, Show, Hide.

    Placement

    Callouts above, below or alternating around the spine.

    Default: Alternate

    Options: Alternate, Above, Below.

    Callout cards

    Shows or hides a card behind each callout.

    Default: Off

    Options: Off, On.

    Text align

    Alignment of the callout text.

    Default: Center

    Options: 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: Diamond

    Options: 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: Range

    Options: 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: Auto

    Options: 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.