Date Field

Date Field

The date field stores date-oriented values.

Best For

  • event dates
  • publish markers
  • timeline steps
  • release or launch dates

Schema Example

{ "name": "eventDate", "label": "Event Date", "type": "date" }

Template Usage

<time datetime="{{ eventDate }}">{{ eventDate }}</time>

Formatted output example:

<time datetime="{{ eventDate }}">
  {{ eventDate | date("F j, Y") }}
</time>

Use It When

Use date when the value should behave like a real date rather than plain text.

Do Not Use It When

Do not use date for:

  • freeform schedule text
  • date ranges written as prose
  • arbitrary labels

Use text or textarea when the value is not a single date-like field.

Technical Notes

  • keep the saved value as a real date-oriented field and format it at render time
  • use filters for presentation instead of storing formatted prose as the field value
  • use one field per meaningful date rather than packing several milestones into one string
  • if the section needs a date range, use separate start and end fields or explicit supporting copy