bellhop by actabl

When to use

Use date range pickers when users need to select a start and end date for filtering or scheduling.

Report Filters

Select date range for analytics reports and data visualizations.

Booking Systems

Choose check-in and check-out dates for reservations.

Time-Based Queries

Filter logs, transactions, or events by date range.

When not to use

  • For single date selection—use date-picker instead
  • For date-time with hours and minutes—add time picker functionality
  • When preset ranges cover most use cases—offer quick select options first
  • For open-ended ranges (from date onwards)—allow null end date

Variants

Three visual variants to fit different UI contexts.

Input Variant

Two separate input fields for start and end dates

Dropdown Outlined

Single dropdown button with outlined style

Dropdown Ghost

Single dropdown button with ghost/subtle style

Features

Date range picker includes powerful features for date selection.

Dual Calendar

Side-by-side calendar view for easy range selection

Year/Month Navigation

Quick navigation to any month and year

Range Highlighting

Visual indication of selected date range

Date Restrictions

Min/max year constraints and disabled dates

Optional Footer

Cancel/Apply buttons for explicit confirmation

Custom Labels

Configurable labels and placeholders

Configuration Options

Customize behavior with various options.

With Footer

Include Cancel/Apply buttons for confirmation

Without Footer

Auto-apply on date selection

Show Other Month Days

Display days from adjacent months

Best Practices

Follow these guidelines when using date range pickers.

Do

  • Provide clear labels for start and end dates
  • Use footer with Apply button for critical selections
  • Set reasonable min/max year constraints
  • Highlight the selected date range clearly
  • Allow easy navigation between months
  • Provide visual feedback during selection

Don't

  • Don't allow end date before start date
  • Don't hide or disable month/year navigation
  • Don't use for single date selection (use date picker)
  • Don't omit labels on input variant
  • Don't set overly restrictive date ranges

Common Use Cases

Examples of where date range pickers work best.

Analytics Dashboards

Filter metrics and reports by date range

Hotel Booking

Select check-in and check-out dates

Event Scheduling

Choose start and end dates for events or campaigns

Transaction History

Filter financial records by date range

Project Timeline

Set project or task duration with dates

Log Viewer

Query system logs within a specific timeframe

Accessibility

Date range pickers are designed to be accessible to all users.

Keyboard Navigation

  • Tab - Navigate between calendars and controls
  • Arrow Keys - Move between dates
  • Enter/Space - Select date
  • Escape - Close calendar without applying
  • All controls are keyboard accessible

Screen Reader

  • Calendar role and structure announced
  • Selected dates are announced
  • Current focused date is communicated
  • Month/year changes are announced
  • Apply/Cancel actions are clearly labeled

Visual Design

  • Clear focus indicators for all interactive elements
  • Sufficient color contrast for dates and labels
  • Selected range is visually distinct
  • Disabled dates have reduced opacity
  • Today's date is clearly marked

Resources

Design and development resources for the Date Range Picker component.

Figma

Available
View in Figma →

Web Components/Angular

Available
View in Storybook →

React

Available
View in Storybook →