Docs

Timeline

A vertical timeline of events with dates, titles, text and markers.

On this page

The Timeline widget tells a story in order: milestones in your company's history, the phases of a project or the program of an event. Each event has a date, a title, a short text and a marker on a vertical line. Events can alternate on both sides of the line and fade in as the visitor scrolls.

A vertical line with four dot markers on a beige background; white cards alternate left and right: 2014 A studio in a spare room, 2017 Our first workplace, 2021 A team of four, 2026 120 projects and counting
A Timeline in the Alternating layout with dot markers.

Add a Timeline

Click Insert in the rail on the left and find Timeline in the Content group, or type "timeline" in the search box. Drag it onto the canvas, or click it to add it next to the selected element. See Add elements.

Each event is a row in Events. Click Add item to add one and drag the handle to reorder. Keep the events in chronological order.

Choose a layout

  • Alternating (centre line) places the events left and right of a line in the middle. Below 768px it switches to a line on the left, so it stays readable on phones.
  • Line on the left or Line on the right keeps all events on one side.
  • Dates beside the line puts every date in a column to the left of the line and every card to the right of it, like a CV or a company history. Set the width of the date column with Date column width in Design → Spacing & line (160px by default). Below 768px it also switches to the line on the left.

Pick a Marker: a Dot, a Ring, each event's Icon, or a Number. Give an event its own Marker color to highlight it.

Turn on Fill the line while scrolling to fill the line as the visitor scrolls: it fills down to the middle of the screen, the markers it has passed take the fill color, and the events it has not reached yet are dimmed. Pick the fill with Filled line color and how faint the events ahead look with Events not reached, both in Design → Spacing & line. A Ring marker and a light Line color show the fill best.

Content tab settings

Content tab · Events
SettingWhat it does
EventsThe list of events.
Date (each item)The date or period, such as "2021" or "Spring 2026".
Title (each item)What happened.
Description (each item)A short explanation.
Icon (each item)Shown when Marker is Icon.
Marker color (each item)A color for this event's marker.
Title HTML tagH1 to H6, DIV, SPAN or P. Default: H3.
Content tab · Layout
SettingWhat it does
LayoutAlternating (centre line), Line on the left, Line on the right or Dates beside the line. Default: Alternating.
MarkerDot, Ring, Icon or Number. Default: Dot.
Card pointerA small arrow from each card toward the line. On by default.
Entrance animationNone, Fade up, Fade in or Slide from the side, as each event scrolls into view. Default: Fade up.
Fill the line while scrollingThe line fills down to the middle of the screen as the visitor scrolls; passed markers take the fill color and events not reached yet are dimmed. With reduced motion, in the editor or without JavaScript the line shows filled. Off by default.

Design tab settings

Design tab
SectionSettings
Spacing & lineSpace between events, Date column width (for Dates beside the line), Space around the line, Line color, Line width, Line style (Solid, Dashed or Dotted), Filled line color (empty: the marker color) and Events not reached (the opacity of the events ahead, 0 to 1, default 0.45), both shown when Fill the line while scrolling is on.
MarkerSize, Color, Icon / number color (for icons and numbers), Halo color (the soft ring around the marker), Icon size, Number typography.
CardBackground, Padding, Border radius, Border, Shadow.
TextDate typography, Date color, Title typography, Title color, Title spacing, Description typography, Description color.

The Design tab also has the sections every element shares: Spacing & position, Background & border and Mask. See Spacing, size & position.

Behaviour tab

The Behaviour tab has the settings every element shares: anchor and classes, entrance animations, motion effects, visibility per device, display conditions and interactions. See Motion & effects.

Tips

  • Events are never hidden in the editor, without JavaScript, or for visitors who prefer reduced motion: the entrance animation only plays when it can. In the same cases Fill the line while scrolling shows the line filled and no event dimmed.
  • On a colored section, give the cards a white Background in Design → Card so they stand out, as in the screenshot above.