# What changed in react-datepicker

> 35 changes in react-datepicker 8 to 9 from its official release notes, upgrade guides and advisories: 1 breaking, 6 new APIs and options. Each one cited. Sources checked 2026-10-28. HTML: https://unstale.sh/npm/react-datepicker/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## react-datepicker 9

### New APIs and options

- Adds aria-label prop support for DatePicker to improve accessibility. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Adds a prop for custom formatting of multi-select dates. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Adds a prop to control month header placement: top, middle, or bottom. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Adds a prop for custom popper positioning in advanced layouts. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Adds a prop to customize weekday header rendering. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Add the timeZone prop to display and handle dates in any timezone; date-fns-tz is an optional peer dependency. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)

### Behavior and default changes

- Calling event.preventDefault() in onClickOutside prevents the calendar from closing, useful for custom portal-based dropdowns in the calendar header. (9.1.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.1.0)
- The calendar view navigates when users type partial dates. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Internal sizing uses em units so it can inherit font size from the parent. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)

### Fixes and other changes

- The calendar no longer breaks due to Safari auto-translate. (9.1.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.1.0)
- Passing date props as strings no longer causes a crash. (9.1.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.1.0)
- TypeScript types for DatePicker props were improved. (9.1.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.1.0)
- The v8 default styles were restored. (9.1.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.1.0)
- An empty :global selector that breaks Lightning CSS was removed. (9.1.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.1.0)
- Clearing a masked input and blurring it now clears the selection. (9.1.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.1.0)
- Base styles were added for month/year select dropdowns. (9.1.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.1.0)
- When strictParsing is false, the native Date fallback is restored. (9.1.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.1.0)
- A warning for the optional date-fns-tz dependency was prevented. (9.1.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.1.0)
- Using withPortal no longer adds an extra wrapper div. (9.1.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.1.0)
- The calendar view updates when selected or startDate props change programmatically. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Allows typing dates before 1800 when minDate permits. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Improves discriminated union type inference for DatePickerProps. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Holiday date strings are parsed as local time to prevent timezone shifts. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Prevents the in-selecting-range highlight from appearing on days outside the current month. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Prevents the month view from jumping when selecting from the second calendar in range mode. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Hiding the popper arrow now properly removes its offset. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Updates preSelection when the input changes in selectsRange mode. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Time input now works with selectsRange, allowing start and end dates to be selected independently. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Time selection now works with selectsRange, allowing start and end dates to be selected independently. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)
- Fixes infinite height growth in the time picker. (9.0.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v9.0.0)

## react-datepicker 8

### Breaking changes

- The calendar now displays the startDate as the first month. (8.10.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v8.10.0)

### Behavior and default changes

- Keyboard accessibility is added for the timepicker. (8.10.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v8.10.0)

### Fixes and other changes

- Keyboard focus no longer gets lost during same-month navigation in inline mode. (8.10.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v8.10.0)
- Standard HTML aria attribute names are supported. (8.10.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v8.10.0)
- Export support is fixed for webpack versions below 5.94. (8.10.0) — [release notes](https://github.com/Hacker0x01/react-datepicker/releases/tag/v8.10.0)