---
title: "Event timeline in Vista | Oplema"
description: "Make an event timeline in Vista: put dated events on a line as callouts, for milestones, launches and histories of change."
url: "https://oplema.com/docs/vista/timelines/event-timeline"
updated: "2026-11-04"
---

# 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.

Result
| 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 |

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.

[Open Vista](https://oplema.com/editor?path=%2F%3Fopen%3Dvista) [About Vista](https://oplema.com/vista)
