--- productId: x-date-pickers title: Date and Time Pickers - Custom slots and subcomponents components: DateTimePickerTabs, PickersActionBar, DatePickerToolbar, TimePickerToolbar, DateTimePickerToolbar, PickersCalendarHeader, PickersRangeCalendarHeader, PickersShortcuts, DateRangePickerToolbar, MonthCalendar, YearCalendar, DateCalendar --- # Custom slots and subcomponents

Learn how to override parts of the Date and Time Pickers.

:::info The components that can be customized are listed under `slots` section in Date and Time Pickers [API Reference](/x/api/date-pickers/). For example, check [available Date Picker slots](/x/api/date-pickers/date-picker/#slots). ::: :::success See [Common concepts—Slots and subcomponents](/x/common-concepts/custom-components/) to learn how to use slots. ::: ## Action bar ### Component props The action bar is available on all picker components. By default, it contains no action on desktop, and the actions **Cancel** and **Accept** on mobile. You can override the actions displayed by passing the `actions` prop to the `actionBar` within `slotProps`, as shown here: ```jsx ({ actions: pickerVariant === 'desktop' ? [] : ['clear'], }), }} /> ``` In the example below, the action bar contains only one button, which resets the selection to today's date: {{"demo": "ActionBarComponentProps.js"}} #### Available actions The built-in `` component supports the following different actions: | Action | Behavior | | :------------- | :------------------------------------------------------------------------------- | | `accept` | Accept the current value and close the picker view. | | `cancel` | Reset to the last accepted date and close the picker view. | | `clear` | Reset to the empty value and close the picker view. | | `next` | Go to the next step in the value picking process. | | `nextOrAccept` | Shows the `accept` or `next` action depending on the value picking process step. | | `today` | Reset to today's date (and time if relevant) and close the picker view. | ### Component If you need to customize the date picker beyond the options described above, you can provide a custom component. This can be used in combination with `slotProps`. In the example below, the actions are the same as in the section above, but they are rendered inside a menu: {{"demo": "ActionBarComponent.js"}} ## Tabs Tabs are available on all date time picker components. They let users switch between date and time interfaces. ### Component props You can override the icons displayed by passing props to the `tabs` within `slotProps`, as shown here: ```jsx , timeIcon: , }, }} /> ``` By default, the tabs are `hidden` on desktop, and `visible` on mobile. This behavior can be overridden by setting the `hidden` prop: ```jsx ``` ### Component If you need to customize the date time picker beyond the options described above, you can provide a custom component. This can be used in combination with `slotProps`. In the example below, the tabs are using different icons and have an additional component: {{"demo": "Tabs.js"}} ## Toolbar The toolbar is available on all date time picker components. It displays the current values and lets users switch between different views. ### Component props You can customize how the toolbar displays the current value with `toolbarFormat`. By default, empty values are replaced by `__`. This can be modified by using `toolbarPlaceholder` props. By default, the toolbar is `hidden` on desktop, and `visible` on mobile. This behavior can be overridden by setting the `hidden` prop: ```jsx ``` ### Component Each component comes with its own toolbar (`DatePickerToolbar`, `TimePickerToolbar`, and `DateTimePickerToolbar`) that you can reuse and customize. {{"demo": "ToolbarComponent.js"}} ## Calendar header The calendar header is available on any component that renders a calendar to select a date or a range of dates. It lets users navigate through months and switch to the month and year views when available. ### Component props You can pass props to the calendar header as shown below: {{"demo": "CalendarHeaderComponentProps.js"}} ### Component You can pass a custom component to replace the header, as shown below: {{"demo": "CalendarHeaderComponent.js"}} When used with a date range component, you receive three additional props to let you handle scenarios where multiple months are rendered: - `calendars`: The number of calendars rendered - `month`: The month used for the header being rendered - `monthIndex`: The index of the month used for the header being rendered The demo below shows how to navigate the months two by two: {{"demo": "CalendarHeaderComponentRange.js"}} ## Year button This button lets users change the selected year in the `year` view. ### Component props You can pass props to the year button as shown below: {{"demo": "YearButtonComponentProps.js"}} ### Component You can pass a custom component to replace the year button, as shown below: {{"demo": "YearButtonComponent.js"}} ## Month button This button lets users change the selected month in the `month` view. :::success You can learn more about how to enable the `month` view on the [`DateCalendar` doc page](/x/react-date-pickers/date-calendar/#views). ::: ### Component props You can pass props to the month button as shown below: {{"demo": "MonthButtonComponentProps.js"}} ### Component You can pass a custom component to replace the month button, as shown below: {{"demo": "MonthButtonComponent.js"}} ## Day The `day` slot is available on any component that renders a calendar to select a date or a range of dates. It lets you customize the appearance and behavior of each individual day cell. ### Component structure change The `PickerDay` and `DateRangePickerDay` components have been simplified to use a single `ButtonBase` element. Previously, they used multiple nested elements to render the selection and preview highlights. These highlights are now rendered using `::before` and `::after` pseudo-elements on the root element. This change brings several benefits: - **Simpler DOM structure**: Fewer nested elements mean a cleaner DOM and potentially better performance. - **Improved consistency**: Both components now follow the same implementation pattern. However, this might affect your custom styles if you were targeting the nested elements. For example, in `DateRangePickerDay`, the `day` class has been removed because there is no longer a separate element for the day content. For more details on how to adapt your custom styles, check the [Day slot migration guide](/x/migration/migration-pickers-v8/#day-slot). ### Examples Use the `--PickerDay-horizontalMargin` and `--PickerDay-size` CSS variables to easily customize the dimensions and spacing of the day slot. {{"demo": "PickerDayDemoCSSVars.js"}} Customize the look and feel by creating a custom theme with `styleOverrides`. {{"demo": "PickerDayDemoCustomTheme.js", "defaultCodeOpen": false}} ## Arrow switcher The following slots let you customize how to render the buttons and icons for an arrow switcher: the component used to navigate to the "Previous" and "Next" steps of the picker: `PreviousIconButton`, `NextIconButton`, `LeftArrowIcon`, `RightArrowIcon`. ### Component props You can pass props to the icons and buttons as shown below: {{"demo": "ArrowSwitcherComponentProps.js", "defaultCodeOpen": false}} ### Component You can pass custom components to replace the icons, as shown below: {{"demo": "ArrowSwitcherComponent.js", "defaultCodeOpen": false}} ## Access date adapter In case you are building a custom component that needs to work with multiple date libraries, you can access the date adapter instance by using the `usePickerAdapter()` hook. This hook returns the date adapter instance used by the picker, which you can use to format dates, parse strings, and perform other date-related operations. :::success If your application uses a single date library, prefer using the date library directly in your components to avoid unnecessary complexity and possible breaking changes. ::: {{"demo": "UsePickerAdapter.js", "defaultCodeOpen": false}} ## Shortcuts You can add shortcuts to every Picker component. For more information, check the [dedicated page](/x/react-date-pickers/shortcuts/).