npm / react-day-picker
react-day-picker
What changed in react-day-picker 8 to 10, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-17.
34 breaking9 new APIs and options1 behavior and defaults15 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initreact-day-picker 1043 changes
Breaking changes 33
Moved the amET locale export to the Ethiopic calendar package.
Removed deprecated button customization entry; use PreviousMonthButton and NextMonthButton.
Removed deprecated DateLib export.
Removed deprecated DateLib export.
Non-Gregorian Ethiopic calendar support is now published as a standalone package, including the moved amET locale export.
Non-Gregorian Persian calendar support is now published as a standalone package.
Removed deprecated compatibility typing for classNames and styles.
Removed deprecated alias; use formatCaption instead.
Removed deprecated DateLib export.
Removed deprecated alias; use formatYearDropdown instead.
Removed deprecated navigation prop; use hidden before and optionally startMonth.
Removed deprecated navigation prop; use startMonth instead.
Removed deprecated navigation prop; use startMonth with a Date instead.
Removed deprecated focus prop; use autoFocus instead.
Removed deprecated alias; use rangeIncludesDate instead.
Removed deprecated alias; use dateMatchModifiers instead.
Removed deprecated alias; use labelGrid instead.
Removed deprecated alias; use labelDayButton instead.
Removed deprecated DateLib export.
Removed deprecated event prop; use a custom DayButton component.
Removed deprecated event prop; use a custom DayButton component.
Removed deprecated event prop; use a custom DayButton component.
Removed deprecated event prop; use a custom DayButton component.
Removed deprecated event prop; use a custom DayButton component.
Removed deprecated event prop; use a custom DayButton component.
Removed deprecated event prop; use a custom DayButton component.
Removed deprecated event prop; use a custom DayButton component.
Removed deprecated event prop; use a custom WeekNumber component.
Removed deprecated Jalali calendar subpath; use the Persian calendar package instead.
Removed deprecated navigation prop; use hidden after and optionally endMonth.
Removed deprecated navigation prop; use endMonth instead.
Removed deprecated navigation prop; use endMonth with a Date instead.
Removed deprecated type exports from the types/deprecated module.
New APIs and options 4
Non-Gregorian Buddhist calendar support is now published as a standalone package.
Non-Gregorian Hebrew calendar support is now published as a standalone package.
Non-Gregorian Hijri calendar support is now published as a standalone package.
Introduced the preferred scoped package name for new projects, including its style sheet import.
Fixes and other changes 6
Date-fns functions and DayPicker locales are imported from subpaths.
Importing a locale subpath no longer loads all date-fns locales.
Focus is preserved when controlled month changes replace the focused day.
Inline styles now apply to all component slots.
Adds @types/react as an optional peer dependency.
Fixed multi-month dropdown navigation so changing month or year shows the expected month.
react-day-picker 915 changes
Breaking changes 1
Calendars now render empty grid cells when endMonth clips the calendar; brittle snapshots or custom CSS depending on the old markup may need updates.
New APIs and options 5
The DayPicker root element receives a default
langprop.Range mode can start a new range when a full range is already selected.
A Hijri (Umm al-Qura) calendar is available through a dedicated import path.
Persian calendars now support narrow weekday formatting.
Adds an experimental prop to help deal with historical time zones with second offsets.
Behavior and default changes 1
Built-in locales now provide translated labels, so developers no longer need to supply translated labels through the labels prop.
Fixes and other changes 8
Corrects Japanese Hiragana locale labels.
Corrects Northern Sami locale labels.
Adds the correct type declaration for the style.css export, improving type-safe usage of the stylesheet export.
Array modifiers now match dates by day, correcting modifier matching behavior.
Hebrew date conversion now handles timezones correctly.
Disabled focused days can no longer be selected, fixing the v9.11.2 regression affecting JSDOM tests.
Focused disabled days remain focusable instead of losing keyboard focusability.
Modifiers now honor the timeZone prop, producing timezone-aware modifier behavior.
react-day-picker 81 changes
Fixes and other changes 1
React 19 is now supported in v8, helping projects adopt newer React versions without peer dependency warnings.