NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #1626 most downloaded on npm
Customizable Date Picker for React
Last release 4 months ago
15 May 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
12 years old
292 releases · first in 2014
fix: focus and autofocus improvements by @gpbl in https://github.com/gpbl/react-day-picker/pull/2265
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v9.0.0-rc.3...v9.0.0-rc.4
deprecate not used onDay* event handlers
useDayPicker hookonDay* event handlerscomponents - now Is possible to extend all the internal componentsaria-live regionFull Changelog: https://github.com/gpbl/react-day-picker/compare/v9.0.0-rc.2...v9.0.0-rc.3
One column per quarter.
CSS variables are now inside the .rdp-caledar scope
.rdp-caledar scopeFull Changelog: https://github.com/gpbl/react-day-picker/compare/v9.0.0-rc.1...v9.0.0-rc.2
feat: add support for UTC, Jalali calendar by @gpbl in https://github.com/gpbl/react-day-picker/pull/2213
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v9.0.0-beta.5...v9.0.0-rc.1
feat: new startMonth, endMonth prop; deprecate props by @gpbl in https://github.com/gpbl/react-day-picker/pull/2198
fromDate, toDate props by @gpbl in https://github.com/gpbl/react-day-picker/pull/2197startMonth, endMonth prop; deprecate props by @gpbl in https://github.com/gpbl/react-day-picker/pull/2198Full Changelog: https://github.com/gpbl/react-day-picker/compare/v9.0.0-beta.4...v9.0.0-beta.5
style(typescript): improved Selection Mode types by @gpbl in https://github.com/gpbl/react-day-picker/pull/2195
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v9.0.0-beta.3...v9.0.0-beta.4
Improved classNames / Tailwind support @gpbl in https://github.com/gpbl/react-day-picker/pull/2175
--rdp-dropdown-gap css variable by @gpbl in https://github.com/gpbl/react-day-picker/pull/2176captionLayout prop not working as expected by @gpbl in https://github.com/gpbl/react-day-picker/pull/2177ChevronFlag interface for disabled chevrons by @gpbl in https://github.com/gpbl/react-day-picker/pull/2178DayDate component by @gpbl in https://github.com/gpbl/react-day-picker/pull/2179data- attribute with WeekNumberFlag by @gpbl in https://github.com/gpbl/react-day-picker/pull/2181Full Changelog: https://github.com/gpbl/react-day-picker/compare/v9.0.0-beta.2...v9.0.0-beta.3
build: React in scope, remove use of tslib by @gpbl in https://github.com/gpbl/react-day-picker/pull/2167
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v9.0.0-beta.1...v9.0.0-beta.2
Version 9 is the next major version of React DayPicker, currently in development.
Version 9 is the next major version of React DayPicker, currently in development.
See http://react-day-picker.js.org/next for the updated documentation and a complete changelog. Please note the documentation is still a work in progress.
Please report any issues or provide feedback on theGitHub Discussions page. We welcome feedback about the upgrade process to ensure it's smooth for everyone.
div grids instead of tablesstrict modeuseInput hook (refer to the documentation for alternatives)Upgrading to v9 will require some changes in your code. See the upgrading guide for more information.
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.10.1...v9.0.0-beta.1
Expands the React peer dependency to include React 19, helping projects still using DayPicker v8 adopt newer React versions without peer dependency wa
Expands the React peer dependency to include React 19, helping projects still using DayPicker v8 adopt newer React versions without peer dependency warnings.
Please note that DayPicker v8 is in maintenance mode. This release is intended to help existing v8 users stay unblocked, but upgrading to v9 is recommended when possible.
If you are still on v8, review the updated upgrade guide:
https://daypicker.dev/upgrading-v8-to-v10
Full Changelog: v8.10.1...v8.10.2
Release date: 2026-05-02
Full release notes at https://github.com/gpbl/react-day-picker/releases
build: fix Preact support by externalizing JSX runtime by @pwolfert in https://github.com/gpbl/react-day-picker/pull/2076
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.10.0...v8.10.1
feat: support for date-fns 3.0 by @gpbl in https://github.com/gpbl/react-day-picker/pull/2003
types/Matchers by @jerodfritz in https://github.com/gpbl/react-day-picker/pull/1964firstWeekContainsDate to be only Monday or Thursday by @gpbl in https://github.com/gpbl/react-day-picker/pull/2004
1 (Monday) and 4 (Thursday) instead of values from 0 to 6. This change may break your type-check.Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.9.1...v8.10.0
Release date: 2023-12-23
types/Matchers by @jerodfritz in #1964firstWeekContainsDate to be only Monday or Thursday by @gpbl in #2004
1 (Monday) and 4 (Thursday) instead of values from 0 to 6. This change may break your type-check.fix(types): PropsWithChildren not compatible with React 17 by @binhpv in https://github.com/gpbl/react-day-picker/pull/1947
PropsWithChildren not compatible with React 17 by @binhpv in https://github.com/gpbl/react-day-picker/pull/1947Locale imports by @gpbl in https://github.com/gpbl/react-day-picker/pull/1948<details> <summary>Updated dependencies</summary>
</details>
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.8.3...v8.9.1
Release date: 2023-10-18
<details> <summary>Updated dependencies</summary>
</details>
Nothing published for this version
fix(a11y): remove redundant rowgroup role from tbody element by @gpbl in https://github.com/gpbl/react-day-picker/pull/1907
rowgroup role from tbody element by @gpbl in https://github.com/gpbl/react-day-picker/pull/1907<details> <summary>Dependencies Updates</summary>
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.8.1...v8.8.2
Release date: 2023-09-12
<details> <summary>Dependencies Updates</summary>
fix: range not selected when missing the from value by @Sam-Apostel in https://github.com/gpbl/react-day-picker/pull/1876
from value by @Sam-Apostel in https://github.com/gpbl/react-day-picker/pull/1876<details> <summary>Toggle list</summary>
</details>
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.8.0...v8.8.1
Release date: 2023-08-18
from value by @Sam-Apostel in #1876<details> <summary>Toggle list</summary>
</details>
feat: add custom ID to grid elements by @GeorgeTaveras1231 in https://github.com/gpbl/react-day-picker/pull/1730
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.7.1...v8.8.0
Release date: 2023-06-19
fix: cannot extend DayPickerProps, DataAttributes interface by @gpbl in https://github.com/gpbl/react-day-picker/pull/1755
DayPickerProps, DataAttributes interface by @gpbl in https://github.com/gpbl/react-day-picker/pull/1755Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.7.0...v8.7.1
feat(rendering): add id, data- attributes to the root element by @gpbl in https://github.com/gpbl/react-day-picker/pull/1745
id, data- attributes to the root element by @gpbl in https://github.com/gpbl/react-day-picker/pull/1745Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.6.0...v8.7.0
Release date: 2023-04-09
id, data- attributes to the root element by @gpbl in #1745feat: new dropdown-buttons caption layout by @seanockert in https://github.com/gpbl/react-day-picker/pull/1678 (see example).
dropdown-buttons caption layout by @seanockert in https://github.com/gpbl/react-day-picker/pull/1678 (see example).displayMonth prop to Footer by @gpbl in https://github.com/gpbl/react-day-picker/pull/1690Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.5.1...v8.6
Release date: 2023-02-18
dropdown-buttons caption layout by @seanockert in #1678 (see example).displayMonth prop to Footer by @gpbl in #1690chore: improve ButtonProps type by @gpbl in https://github.com/gpbl/react-day-picker/pull/1666
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.5.0...v8.5.1
use gridcell directly in button, deprecate labelDay
CaptionLabel to have role presentationgridcell directly in button, deprecate labelDayrowgroup for tbodyFull Changelog: https://github.com/gpbl/react-day-picker/compare/v8.4.1...v8.5.0
Release date: 2023-01-24
CaptionLabel to have role presentationgridcell directly in button, deprecate labelDayrowgroup for tbodyfeat: add onDayPointerEnter, onDayPointerLeave props by @norbertkeresztes in https://github.com/gpbl/react-day-picker/pull/1614
onDayPointerEnter, onDayPointerLeave props by @norbertkeresztes in https://github.com/gpbl/react-day-picker/pull/1614Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.3.7...v8.4.1
Release date: 2022-12-17
onDayPointerEnter, onDayPointerLeave props by @norbertkeresztes in #1614Nothing published for this version
chore(style): add opacity to differentiate outside days by @hpdganesh in https://github.com/gpbl/react-day-picker/pull/1592
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.3.6...v8.3.7
Release date: 2022-11-20
fix: set tab-index to 0 when day is focused by @gpbl in https://github.com/gpbl/react-day-picker/pull/1601
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.3.5...v8.3.6
fix: range_middle class is added to days not in the selected range by @gpbl in https://github.com/gpbl/react-day-picker/pull/1581
range_middle class is added to days not in the selected range by @gpbl in https://github.com/gpbl/react-day-picker/pull/1581Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.3.4...v8.3.5
build: fix CSS module types by @gpbl in https://github.com/gpbl/react-day-picker/pull/1578
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.3.1...v8.3.2
Release date: 2022-10-09
Nothing published for this version
Nothing published for this version
fix: types for selection modes not being correctly set by @gpbl in https://github.com/gpbl/react-day-picker/pull/1571
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.3.0...v8.3.1
feat: add new id prop by @gpbl in https://github.com/gpbl/react-day-picker/pull/1556
id prop by @gpbl in https://github.com/gpbl/react-day-picker/pull/1556ISOWeek, firstWeekContainsDate by @gpbl in https://github.com/gpbl/react-day-picker/pull/1558focus-visible and disabled styles by @gpbl in https://github.com/gpbl/react-day-picker/pull/1565SelectSingleEventHandler interface to type by @gpbl in https://github.com/gpbl/react-day-picker/pull/1555Components type by @gpbl in https://github.com/gpbl/react-day-picker/pull/1563Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.2.1...v8.3.0
Release date: 2022-09-26
id prop by @gpbl in #1556ISOWeek, firstWeekContainsDate by @gpbl in #1558focus-visible and disabled styles by @gpbl in #1565SelectSingleEventHandler interface to type by @gpbl in #1555Components type by @gpbl in #1563fix: CSS module doesn't include the root class by @gpbl in https://github.com/gpbl/react-day-picker/pull/1548
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.2.0...v8.2.1
new: custom HeadRow component by @gpbl in https://github.com/gpbl/react-day-picker/pull/1534
HeadRow component by @gpbl in https://github.com/gpbl/react-day-picker/pull/1534HeadRow component by @KonradLinkowski in https://github.com/gpbl/react-day-picker/pull/1533Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.1.4...v8.2.0
fix: use parsed fromDate/toDate in useInput by @hypergeometric in https://github.com/gpbl/react-day-picker/pull/1524
fromDate/toDate in useInput by @hypergeometric in https://github.com/gpbl/react-day-picker/pull/1524Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.1.3...v8.1.4
fix: onDayClick called twice in selection mode by @gpbl in https://github.com/gpbl/react-day-picker/pull/1520
onDayClick called twice in selection mode by @gpbl in https://github.com/gpbl/react-day-picker/pull/1520undefined for the modifier props by @gpbl in https://github.com/gpbl/react-day-picker/pull/1521Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.1.2...v8.1.3
fix: do not focus disabled or hidden days by @gpbl in https://github.com/gpbl/react-day-picker/pull/1519
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.1.1...v8.1.2
fix: prevent focus from moving beyond toDate and fromDate by @kimamula in https://github.com/gpbl/react-day-picker/pull/1468
toDate and fromDate by @kimamula in https://github.com/gpbl/react-day-picker/pull/1468setMonth by @kimamula in https://github.com/gpbl/react-day-picker/pull/1510onSelect to the DayPickerContextValue by @gpbl in https://github.com/gpbl/react-day-picker/pull/1515className by @gpbl in https://github.com/gpbl/react-day-picker/pull/1517Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.1.0...v8.1.1
new: add prefix to auto generated ids by @mihkeleidast in https://github.com/gpbl/react-day-picker/pull/1493
addedToRange to the exported utilities by @stopr29 in https://github.com/gpbl/react-day-picker/pull/1495disabled attribute instead of aria-disabled (reverts by @gpbl in https://github.com/gpbl/react-day-picker/pull/1451). See ongoing discussion in https://github.com/gpbl/react-day-picker/pull/1468.@reach/auto-id warnings by removing the dependency by @gpbl in https://github.com/gpbl/react-day-picker/pull/1484startOfWeek by @apdrsn in https://github.com/gpbl/react-day-picker/pull/1492Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.0.7...v8.1.0
Release date: 2022-08-11
addedToRange to the exported utilities by @stopr29 in #1495disabled attribute instead of aria-disabled (reverts by @gpbl in #1451). See ongoing discussion in #1468.@reach/auto-id warnings by removing the dependency by @gpbl in #1484startOfWeek by @apdrsn in #1492fixed: missing dropdown_year CSS class in YearsDropdown by @pwolfert in https://github.com/gpbl/react-day-picker/pull/1466
dropdown_year CSS class in YearsDropdown by @pwolfert in https://github.com/gpbl/react-day-picker/pull/1466Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.0.6...v8.0.7
fix(docs): fix typo by @denkristoffer in https://github.com/gpbl/react-day-picker/pull/1457
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.0.5...v8.0.6
fix(docs): typo in property name by @dzek69 in https://github.com/gpbl/react-day-picker/pull/1442
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.0.4...v8.0.5
Added src directory to the package for better source maps
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.0.3...v8.0.4
Release date: 2022-04-14
fix: toMonth to include the full month by @mputilov in https://github.com/gpbl/react-day-picker/pull/1429
Full Changelog: https://github.com/gpbl/react-day-picker/compare/v8.0.2...v8.0.3
new: split the Caption components into CaptionDropdowns and CaptionNavigation components
Added React 18 to the peer dependencies
This version Introduces mayor breaking changes and is mostly incompatible with v7.
This version Introduces mayor breaking changes and is mostly incompatible with v7.
Head over the redesigned website at https://react-day-picker.js.org for more details.
DayPickerInput component with useInput hookSee also: https://react-day-picker.js.org/guides/upgrading
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →