Like what we’re doing? Star us on GitHub!

Date Field

This field uses react-datepicker for the Admin panel component.


name *To be used as the property name when stored and retrieved from the database. More
labelText used as a field label in the Admin panel or an object with keys for each language.
indexBuild a MongoDB index for this field to produce faster queries. Set this field to true if your users will perform queries on this field's data often.
validateProvide a custom validation function that will be executed on both the Admin panel and the backend. More
saveToJWTIf this field is top-level and nested in a config supporting Authentication, include its data in the user JWT.
hooksProvide field-based hooks to control logic for this field. More
accessProvide field-based access control to denote what users can see and do with this field's data. More
hiddenRestrict this field's visibility from all APIs entirely. Will still be saved to the database, but will not appear in any API or the Admin panel.
defaultValueProvide data to be used for this field's default value. More
localizedEnable localization for this field. Requires localization to be enabled in the Base config.
requiredRequire this field to have a value.
adminAdmin-specific configuration. See below for more detail.

* An asterisk denotes that a property is required.

Admin Config

In addition to the default field admin config, you can customize the following fields that will adjust how the component displays in the admin panel via the date property.

pickerAppearanceDetermines the appearance of the datepicker: dayAndTime timeOnly dayOnly monthOnly. Defaults to dayAndTime.
displayFormatDetermines how the date is presented. dayAndTime default to MMM d, yyy h:mm a timeOnly defaults to h:mm a dayOnly defaults to MMM d, yyy and monthOnly defaults to MM/yyyy.
placeholderPlaceholder text for the field.
monthsToShowNumber of months to display max is 2. Defaults to 1.
minDatePassed directly to react-datepicker.
maxDatePassed directly to react-datepicker.
minTimePassed directly to react-datepicker.
maxTimePassed directly to react-datepicker.
timeIntervalsPassed directly to react-datepicker. Defaults to 30 minutes.
timeFormatPassed directly to react-datepicker. Defaults to 'h:mm aa'.

* An asterisk denotes that a property is required.

Common use cases for customizing the date property are to restrict your field to only show time or day input—but lots more can be done.



import { CollectionConfig } from 'payload/types';
const ExampleCollection: CollectionConfig = {
slug: 'example-collection',
fields: [
name: 'time', // required
type: 'date', // required
label: 'Event Start Time',
defaultValue: '1988-11-05T8:00:00.000+05:00',
admin: {
date: {
// All config options above should be placed here
pickerAppearance: 'timeOnly',

Email Field