HomeDev GuideRecipesAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

DateTime property

Manage datetime properties in Optimizely CMS 13. Learn to configure date and time fields for content, events, and scheduling.

The DateTime property type stores date and time values. Use it to add date-based fields for scheduling, event tracking, or time-stamping content. The following image shows a DateTime property type example.

Screenshot of a DateTime property type configuration example where defining the property settings

The DateTime property renders a field in the All Properties edit view where you can enter a date and time, or specify them from the calendar picker.

Screenshot of the DateTime field in the All Properties edit view where entering a date and time or using the calendar picker

Configure DateTime property

The following attributes are available when you configure a DateTime property.

  • Name – Enter the name of this DateTime property type. This name is used for programming and language settings.

  • Type – Lets you change the content type to any other.

  • Min value – Enter or click the calendar to select the earliest date this content type permits.

  • Max value – Enter or click the calendar to select the latest date this content type permits.

  • Value must be entered – Select to require the user to enter a value in a text field. Required fields display a red asterisk (*).

  • Unique value per language – See Define language-specific properties.

  • List – Unavailable.

  • Property Indexing Type – Select one of the following to determine how the property is indexed for search. The correct setting depends on the nature of the data in the property and how you intend data to be searched or queried.

    • Default – Lets the system decide automatically how to index a property based on its type and context. For instance, string properties are indexed by default to permit full-text search, while date or number values are indexed differently to permit for ranged queries.
    • Queryable – Indexes in a way to be part of search queries. For example, this indexing type lets you run a search query such as Find all pages where PropertyName equals Value.
    • Searchable – Search data inside the property through the search function. For example, use it as part of a free text search where the system looks through searchable fields to find a match. This is useful when you want a content editor or end user to search a body of text, like a product description. It is beneficial to avoid undesired property values in the search index. By default, all properties are searchable.
    • Disabled – The property is not indexed for searching purposes. It is not used in search queries, and its content is not searched. This is often used for properties that contain data irrelevant to search results, and disabling indexing enhances system performance.
  • Default value – Select the options to define what value the Number field displays.

    • No default value – The field is empty (no pre-populated content).

    • Inherits value – The field value is derived from another source. This is often used in hierarchical systems where child elements inherit values from their parent elements. For example, a sub-page inherits some property values from its parent page.

    • Custom – Enter the field's default value. For example, you can set the default date and time as 12/13/2024 at 7 p.m.

      Screenshot of the custom default value setting where specifying a default date and time for the DateTime field
  • Display in edit view – Select to display this DateTime element on your page. Clear it to hide the DateTime element while keeping all the property information.

  • Display name – Enter the text you want to display above the DateTime element on the page in the All Properties view.

  • Help text – Enter text to display next to the Display Name. The following image shows how the help text displays.

    Screenshot of help text displayed next to the Display Name where providing guidance for the DateTime field
  • Sort index – Specify a value to determine the order in which data is displayed or processed.

  • Property Group – Select a property group (Categories, Content, Dynamic Blocks, Preview, Scheduling, SEO Settings, Shortcut) to organize your content on tabs in the All Properties edit view of the content type. The following image shows the DateTime field on the Scheduling tab (property group).

    Screenshot of the DateTime field on the Scheduling tab where showing the property group placement in All Properties view