Back to compare picker

Calendar view vs Date picker vs Timeline vs List view

Use calendar view when scheduled items must be understood by date, time, duration, recurrence, and visual overlap; use date picker, timeline, or list view when the task is narrower.

Learn the decision

Match the interaction to the person's task

Use calendar view when scheduled items must be understood by date, time, duration, recurrence, and visual overlap; use date picker, timeline, or list view when the task is narrower.

Calendar view

Use it when: Users need to scan or manage scheduled events across dates, days, weeks, months, or resources.

Make this state clear: Default calendar state with visible range, view mode, timezone, today marker, selected date, and event count.

Observe the result: A dispatcher switches from month to week, opens Wednesday, sees three overlapping room bookings, chooses an available slot, and receives conflict-aware feedback before saving.

Study the full pattern →

Date picker

Use it when: Users are scheduling, booking, planning, or selecting a recent or future date.

Make this state clear: Closed labelled text field with visible date-format hint and calendar button.

Observe the result: A user opens the calendar, sees weekends unavailable, moves to August, chooses Tuesday 11 August 2026, and reviews stored value 2026-08-11.

Study the full pattern →

Timeline

Use it when: Users need a chronological record of important events for one object, case, order, application, or process.

Make this state clear: Default timeline with heading, order label, date or phase groups, and event markers.

Observe the result: A caseworker filters the timeline to System events, sees two date groups hidden, restores all events, and the event order and current marker stay stable.

Study the full pattern →

List view

Use it when: Users need to scan and act on a collection of objects using compact summaries.

Make this state clear: Default list state with label or heading, row count or context, visible row summaries, and primary row identity.

Observe the result: A user filters tickets to Critical, selects two rows, opens the details panel for one ticket, then clears the filter and the selected count and active ticket remain understandable.

Study the full pattern →

Practice the judgment: Imagine this situation: A responsive layout crushes event titles into unreadable cells instead of switching to an agenda list. Write the person's goal, choose one of these patterns, and show the state that helps the person continue. Use the decision rules and source trail below to explain your choice.

Review the underlying principle →

Decision dimensions

Dimension Calendar viewDate pickerTimelineList view
UI or UX UI + UX - Date and time grid for scheduled events, availability, and conflictsUI + UX - Single-date text field with attached calendar menuUI + UX - Bounded chronological record of past, current, or expected eventsUI + UX - Vertical object-summary browsing surface
UI guidance Render a calendar view around a visible date range, mode switcher, today marker, weekday or time-axis labels, timezone, selected date, and event blocks with start, end, title, status, and all-day or timed placement.Render a labelled date text field with a persistent format hint and a calendar button that opens a month grid aligned to the field.Render the timeline as a labelled chronological sequence where each event has a visible date or time, event title, actor or system source when known, status or type, and a short summary.Render a labelled vertical list where each row has a strong primary label, concise supporting text, metadata, status, optional leading media, and row-scoped actions with clear hit targets.
UX guidance Use calendar view when users need to understand or manage scheduled items by their position in time: date, weekday, duration, overlap, availability, recurrence, or resource assignment.Use a date picker when choosing a date requires calendar context such as weekday, nearby availability, booking windows, deadlines, or recent/future scheduling.Use timeline when users need to understand what happened, where they are now, and what may happen next in a case, claim, application, order, incident, or process.Use list view when scanning and opening object summaries is faster than comparing columns or inspecting large visual cards.
Good UI A clinic schedule shows June 2026 week view, today marker, timezone, business hours, all-day staff training, timed appointments, room labels, overlap warning, and a More link for crowded days.An appointment booking field shows Appointment date, hint mm/dd/yyyy, a calendar button, July 2026 grid, disabled weekends, today marker, and selected July 14 date.A benefits application timeline groups events by date and shows Application submitted, Evidence requested, Evidence received, Decision pending, and Next review, with actor, timestamp, and status marker.A ticket list row shows TCK-2048 Database backup failed, a one-line incident summary, Critical status, owner, updated time, selected state, and a labelled More actions menu.
Bad UI Calendar navigation resets filters, selected calendars, selected date, or opened event unexpectedly.A grid of unlabeled numbers uses pale grey for unavailable dates but still lets users click them before showing a late error.A dense audit table is squeezed into timeline cards and hides changed fields, exact actor identity, and retention proof.Every row has five unlabeled icon buttons, and the whole row also navigates.
Good UX A dispatcher switches from month to week, opens Wednesday, sees three overlapping room bookings, chooses an available slot, and receives conflict-aware feedback before saving.A user opens the calendar, sees weekends unavailable, moves to August, chooses Tuesday 11 August 2026, and reviews stored value 2026-08-11.A caseworker filters the timeline to System events, sees two date groups hidden, restores all events, and the event order and current marker stay stable.A user filters tickets to Critical, selects two rows, opens the details panel for one ticket, then clears the filter and the selected count and active ticket remain understandable.
Bad UX A user taps +3 more in a crowded date cell but the calendar navigates away instead of showing the hidden events for that day.A user selects a disabled Saturday because it was only dimmed, then loses their previous month when the error appears.A user sees a future appointment marker styled like completed history and assumes the appointment already happened.A user tries to preview a file but the row click opens navigation while the small trailing icon deletes the file.
Best fit Users need to scan or manage scheduled events across dates, days, weeks, months, or resources.Users are scheduling, booking, planning, or selecting a recent or future date.Users need a chronological record of important events for one object, case, order, application, or process.Users need to scan and act on a collection of objects using compact summaries.
Avoid when Users only need to select one date for a form field.The date is far in the past, such as a birthday or historic document date.The surface is a live stream whose content keeps arriving and must preserve reader position.Users need to compare many records across shared attributes.
Required state Default calendar state with visible range, view mode, timezone, today marker, selected date, and event count.Closed labelled text field with visible date-format hint and calendar button.Default timeline with heading, order label, date or phase groups, and event markers.Default list state with label or heading, row count or context, visible row summaries, and primary row identity.
Accessibility burden Expose date navigation, mode switch, visible range, selected date, today, timezone, and event count as text.Give the calendar button an accessible name and state that distinguishes opening from closing the menu.Use semantic list or ordered-list structure with date-group headings and text event labels.Use semantic list markup for ordinary object lists; use listbox only when rows are options in a single control.
Common misuse Using calendar view as a decorative month card for unscheduled content.Using a calendar picker for a date of birth or other remembered historic date.Omitting dates, actors, or event summaries and expecting icons to communicate the sequence.Putting too many independent controls in every row until the list becomes a keyboard trap.

Calendar view

UI or UX
UI + UX - Date and time grid for scheduled events, availability, and conflicts
UI guidance
Render a calendar view around a visible date range, mode switcher, today marker, weekday or time-axis labels, timezone, selected date, and event blocks with start, end, title, status, and all-day or timed placement.
UX guidance
Use calendar view when users need to understand or manage scheduled items by their position in time: date, weekday, duration, overlap, availability, recurrence, or resource assignment.
Good UI
A clinic schedule shows June 2026 week view, today marker, timezone, business hours, all-day staff training, timed appointments, room labels, overlap warning, and a More link for crowded days.
Bad UI
Calendar navigation resets filters, selected calendars, selected date, or opened event unexpectedly.
Good UX
A dispatcher switches from month to week, opens Wednesday, sees three overlapping room bookings, chooses an available slot, and receives conflict-aware feedback before saving.
Bad UX
A user taps +3 more in a crowded date cell but the calendar navigates away instead of showing the hidden events for that day.
Best fit
Users need to scan or manage scheduled events across dates, days, weeks, months, or resources.
Avoid when
Users only need to select one date for a form field.
Required state
Default calendar state with visible range, view mode, timezone, today marker, selected date, and event count.
Accessibility burden
Expose date navigation, mode switch, visible range, selected date, today, timezone, and event count as text.
Common misuse
Using calendar view as a decorative month card for unscheduled content.

Date picker

UI or UX
UI + UX - Single-date text field with attached calendar menu
UI guidance
Render a labelled date text field with a persistent format hint and a calendar button that opens a month grid aligned to the field.
UX guidance
Use a date picker when choosing a date requires calendar context such as weekday, nearby availability, booking windows, deadlines, or recent/future scheduling.
Good UI
An appointment booking field shows Appointment date, hint mm/dd/yyyy, a calendar button, July 2026 grid, disabled weekends, today marker, and selected July 14 date.
Bad UI
A grid of unlabeled numbers uses pale grey for unavailable dates but still lets users click them before showing a late error.
Good UX
A user opens the calendar, sees weekends unavailable, moves to August, chooses Tuesday 11 August 2026, and reviews stored value 2026-08-11.
Bad UX
A user selects a disabled Saturday because it was only dimmed, then loses their previous month when the error appears.
Best fit
Users are scheduling, booking, planning, or selecting a recent or future date.
Avoid when
The date is far in the past, such as a birthday or historic document date.
Required state
Closed labelled text field with visible date-format hint and calendar button.
Accessibility burden
Give the calendar button an accessible name and state that distinguishes opening from closing the menu.
Common misuse
Using a calendar picker for a date of birth or other remembered historic date.

Timeline

UI or UX
UI + UX - Bounded chronological record of past, current, or expected events
UI guidance
Render the timeline as a labelled chronological sequence where each event has a visible date or time, event title, actor or system source when known, status or type, and a short summary.
UX guidance
Use timeline when users need to understand what happened, where they are now, and what may happen next in a case, claim, application, order, incident, or process.
Good UI
A benefits application timeline groups events by date and shows Application submitted, Evidence requested, Evidence received, Decision pending, and Next review, with actor, timestamp, and status marker.
Bad UI
A dense audit table is squeezed into timeline cards and hides changed fields, exact actor identity, and retention proof.
Good UX
A caseworker filters the timeline to System events, sees two date groups hidden, restores all events, and the event order and current marker stay stable.
Bad UX
A user sees a future appointment marker styled like completed history and assumes the appointment already happened.
Best fit
Users need a chronological record of important events for one object, case, order, application, or process.
Avoid when
The surface is a live stream whose content keeps arriving and must preserve reader position.
Required state
Default timeline with heading, order label, date or phase groups, and event markers.
Accessibility burden
Use semantic list or ordered-list structure with date-group headings and text event labels.
Common misuse
Omitting dates, actors, or event summaries and expecting icons to communicate the sequence.

List view

UI or UX
UI + UX - Vertical object-summary browsing surface
UI guidance
Render a labelled vertical list where each row has a strong primary label, concise supporting text, metadata, status, optional leading media, and row-scoped actions with clear hit targets.
UX guidance
Use list view when scanning and opening object summaries is faster than comparing columns or inspecting large visual cards.
Good UI
A ticket list row shows TCK-2048 Database backup failed, a one-line incident summary, Critical status, owner, updated time, selected state, and a labelled More actions menu.
Bad UI
Every row has five unlabeled icon buttons, and the whole row also navigates.
Good UX
A user filters tickets to Critical, selects two rows, opens the details panel for one ticket, then clears the filter and the selected count and active ticket remain understandable.
Bad UX
A user tries to preview a file but the row click opens navigation while the small trailing icon deletes the file.
Best fit
Users need to scan and act on a collection of objects using compact summaries.
Avoid when
Users need to compare many records across shared attributes.
Required state
Default list state with label or heading, row count or context, visible row summaries, and primary row identity.
Accessibility burden
Use semantic list markup for ordinary object lists; use listbox only when rows are options in a single control.
Common misuse
Putting too many independent controls in every row until the list becomes a keyboard trap.
Decision rules
  • Choose calendar view when users need to scan or manage multiple scheduled events across days, weeks, or months and the placement of each event on a date or time grid changes the decision.
  • Choose date picker when the user only needs to choose one date for a field; do not show a full event calendar when there are no event blocks, ranges, all-day items, or schedule conflicts to inspect.
  • Choose timeline when the task is to understand a bounded history or sequence for one case, order, or process rather than to compare open time slots or overlapping future events.
  • Choose list view when users need a compact vertical agenda for a known interval and spatial placement by weekday or hour is less important than scanning titles, owners, or actions.
  • Calendar view should expose the visible date range, timezone, day/week/month mode, today marker, selected date, event start and end, all-day status, recurrence, overflow count, and empty days.
  • Use calendar overflow disclosure such as plus-more links or popovers when a day has more events than fit; do not silently hide remaining events in a month cell.
  • Use time-grid or resource calendar variants when users need to compare duration, overlap, business hours, rooms, people, or equipment availability.
  • Use agenda/list fallback on narrow screens when grid density would make event titles, selected state, or keyboard focus unreadable.
  • Do not use calendar view as a decorative monthly card for records that are not scheduled; a table, list view, timeline, or activity log may preserve identity and metadata better.
  • If drag, resize, or create-on-slot behavior is allowed, show constraints, conflict handling, undo or confirmation, and focus recovery after the event moves.
Inspect live examples
Failure modes
  • A month grid hides extra events without a count or overflow popover.
  • A dense weekly schedule allows overlapping drag moves without conflict feedback or undo.
  • A responsive layout crushes event titles into unreadable cells instead of switching to an agenda list.
  • The calendar shows local dates while exports, reminders, or attendees use a different timezone.
  • All-day, multi-day, recurring, cancelled, tentative, and unavailable events are visually indistinguishable.
  • A date picker is expanded into a full calendar page even though users only need to enter one known date.

Saved items