Skip to main content
Add a timeline entry to admin.views to show each document as a bar from its start date to its end date, on a day, week or month scale. Bands split the bars by one field, as columns split a board. Include a list entry when users should be able to switch between table and timeline layouts. See the complete Collection views reference.

Timeline properties

Timeline components

Startup checks the view’s settings: Nested fields use dot paths such as schedule.startsAt.

Scales and bands

Today comes back to the current date. On a narrow screen, the band names stay pinned on the left and the bars scroll sideways inside the timeline. With groupBy, bands follow the board’s rules: a select, radio or checkbox field shows every option in its declared order, even with no records, and other fields show the values records have. Records with no value sit in a last No value band, shown when it has any. Bars that overlap within a band stack into rows; bars that don’t share a row.

Dates and time zones

Bars land on the same days as in the calendar: a moment shows on its day in the viewer’s browser time zone, and a date field with pickerAppearance 'dayOnly' or 'monthOnly' shows on its saved date for every viewer.
  • A record with both dates is a bar from its start day to its end day. A timed end at exactly midnight ends on the day before, with or without a start date.
  • A record with only one of the two dates is a one-day bar on that date. Dragging its free edge fills in the other date on the day it is dropped, at the existing date’s time of day, or at noon when the existing date is date-only.
  • A record with neither date isn’t shown.
Each visible range loads only the records that overlap it, with the view’s filter and the current search, at most 1000 at a time.

Moving and resizing

  • Move. Drag a bar sideways to move it by whole days. Both dates move and keep their time of day, even across a daylight-saving change.
  • Resize. Drag a bar’s left edge to change its start date, and its right edge to change its end date. An edge stops where the bar is one day long, so the end never moves before the start.
On a touch screen:
  • A sideways drag on a bar moves it, a vertical swipe scrolls the page, and a drag on the empty track scrolls the timeline.
  • Edge handles are 44px wide and reach up to 23px into the bar.
On a narrow bar, each handle covers at most a quarter of the bar, so the middle always opens or moves the bar. Dragging a bar never changes its band: change the grouped field in the record. Each change is a normal collection update, with access checks, validation and hooks. If it fails, the bar goes back and the error shows. Users without update access to the date fields can view bars but not move them. Click a bar, or focus it and press Enter, to open the record in the record panel. Saving or deleting there updates the timeline. The selected scale and date are saved per user and view. URL values take precedence over saved preferences, which take precedence over the configured defaults. With the collection’s admin.useAsDone set, done records show a green check and a muted title. The record open in the panel shows the shared selected style.