Activity

Sourced from react-day-picker's releases.

v10.0.0

DayPicker v10 removes the public APIs deprecated in v9 and introduces a new @daypicker/react package name. Non-Gregorian calendars are now published as standalone @daypicker/* packages.

If your app already uses the current v9 API, the upgrade should be relatively small. If your app still relies on deprecated v9 APIs, those usages should be updated before upgrading.

See the full v10 changelog, the upgrade guide, and the v10 announcement for questions and upgrade feedback.

Install

npm install react-day-picker@latest

For new projects, prefer the scoped package name:

npm install @daypicker/react@latest

import { DayPicker } from "@daypicker/react";
import "@daypicker/react/style.css";

The react-day-picker package remains available in v10 for compatibility.

Breaking Changes

Deprecated navigation props removed

Removed prop	Use instead
fromMonth	startMonth
fromYear	startMonth={new Date(year, 0)}
toMonth	endMonth
toYear	endMonth={new Date(year, 11)}
fromDate	hidden={{ before: date }} and optionally startMonth
toDate	hidden={{ after: date }} and optionally endMonth

Deprecated focus and event props removed

Removed prop	Use instead
initialFocus	autoFocus
onWeekNumberClick	A custom WeekNumber component
onDayKeyUp	A custom DayButton component
onDayKeyPress	A custom DayButton component
onDayPointerEnter	A custom DayButton component
onDayPointerLeave	A custom DayButton component
onDayTouchCancel	A custom DayButton component

... (truncated)

Sourced from react-day-picker's changelog.

v10.0.0

Release date: 2026-05-08

This major release introduces the @daypicker/react package name, publishes calendar add-on packages under the @daypicker/* scope, and removes public APIs that were deprecated in v9.

Upgrading to v10

Upgrading from v9 should be straightforward if your app does not use any deprecated APIs. See the upgrading guide for details. If you use one of the non-Gregorian calendars, such as Persian, Hebrew, Buddhist, Ethiopic, or Hijri, install the corresponding calendar add-on package alongside DayPicker.

Package Name

For new projects, prefer the @daypicker/react package:

import { DayPicker } from "@daypicker/react";
import "@daypicker/react/style.css";

The react-day-picker package remains available for compatibility and exposes the same DayPicker API in v10.

Calendar Packages

Calendar add-on packages are now published under the @daypicker/* scope. Install the add-on package for the calendar you need alongside @daypicker/react. For example, to use the Persian calendar:

npm install @daypicker/react @daypicker/persian

Breaking Changes

• Removed deprecated props: fromDate, toDate, fromMonth, toMonth, fromYear, toYear, initialFocus.
• Removed deprecated event props: onWeekNumberClick, onDayKeyUp, onDayKeyPress, onDayPointerEnter, onDayPointerLeave, onDayTouchCancel, onDayTouchEnd, onDayTouchMove, onDayTouchStart.
• Removed deprecated type exports from types/deprecated.
• Removed deprecated aliases: formatMonthCaption, formatYearCaption, labelDay, labelCaption, isMatch, isDateInRange.
• Removed the deprecated components.Button customization entry.
• Removed deprecated DeprecatedUI compatibility typing for classNames and styles.
• Removed deprecated DateLib exports: FormatOptions, LabelOptions, dateLib, and DateLib.Date.
• Removed the deprecated react-day-picker/jalali subpath. Use react-day-picker/persian.

What's Changed

• feat: add @daypicker/react as the preferred package name by @​gpbl in #2970
• feat: publish calendar add-on packages under the @daypicker/* scope
• fix: show the expected month after dropdown changes in multi-month calendars by @​hackgray47-eng in #2977
• fix: move the amET locale export to @daypicker/ethiopic by @​gpbl in #2968

• 2c5ba1f build: version packages (#2989)
• b55a878 fix: correct dropdown navigation in multi-month calendars (#2977)
• 6af9b1f docs: fill type alias API descriptions (#2991)
• 2907c64 build: version packages (next) (#2965)
• cdc5a64 docs: update v8 website references
• 2f8627d docs: format with prettier
• 0ce053f docs: prefer scoped DayPicker package (#2975)
• b093f00 fix: preserve legacy nav layout default (#2973)
• 19b8d33 test: standardize Jest test lifecycle patterns (#2972)
• 8cef1c7 test: lock Date behavior before Temporal prep (#2971)
• Additional commits viewable in compare view