---
sourceDocument: Brazil Sales Customer Relationship Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/order-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Sales Customer Relationship Management

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# The calendar display component

# The calendar display component {#ariaid-title1}

Release version: Brazil  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of The calendar display component

The calendar display component in ServiceNow CPQ provides a monthly view to present and manage time-based configuration options.
It enables users to view, select, and interact with date-specific records directly within the configuration interface, enhancing usability for time-sensitive selections.
Show full answer Show less  

## Key Features

* **Monthly Calendar View:** Displays a set of records where each day corresponds to one record, facilitating day-by-day interaction.
* **Set Configuration:** Uses a set (e.g., named *availableDates* ) containing fields such as *selectedDate* (Boolean for user selection), *rawDate* (text in standardized date format), and *availableDate* (human-readable date).
* **Load Size Picklist:** Allows administrators to define options (S, M, L) for each day, supporting additional configuration per calendar day.
* **Field Limits:** Administrators should limit the number of fields per calendar day to maintain application responsiveness and accommodate screen sizes.
* **On Configure/Reconfigure Enrichment:** Initializes the calendar set with appropriate monthly data and outputs JSON representing the calendar records, which can be customized as needed.
* **Blueprint Layout and Selection Settings:** Define placement of the calendar and fields displayed per day, and configure whether users can select single or multiple days via Boolean fields.
* **Search Settings:** Enable filtering to display the most relevant days when multiple months are involved, by mapping source and target fields within the set.
* **Raw Value JSON Editing:** Because the calendar display type is not selectable by default, administrators must manually edit JSON definitions to explicitly configure the calendar display.

## Practical Use for ServiceNow Customers

This component empowers administrators to build intuitive, time-based configuration options that improve user experience when selecting dates within CPQ processes. By leveraging sets and fields, customers can tailor calendar displays to specific use cases, such as booking, availability selection, or scheduling within product configurations.

Careful configuration of selection rules, field limits, and JSON outputs ensures optimal performance and usability across devices. The component's flexibility in defining user interactions and data presentation supports diverse business needs for time-sensitive configurations.  
Use the calendar display component in ServiceNow CPQ to present time-based configuration options in a monthly view. Configure sets, fields, and selection settings to let users view, select, and manage date-specific records directly in the configuration
interface.

ServiceNow CPQ native UI allows the administrator to present a calendar display component to the user to aid in time-based configurations. The calendar displays in the context of a month. The data underlying the calendar
display is a set, with each calendar day represented by one record in the set.

The example below shows a set with 30 records, one for each day, represented as a calendar display component.


Key elements that support this example include a set with the variable name `availableDates`. This set contains the following associated fields:

* `selectedDate` (Boolean): captures whether the user has selected one or more date/records
* `rawDate` (Text): holds the raw date formatted for each set record
* `availableDate` (Text); holds the date in "MM/DD/YYYY" format for each set record. This is used to facilitate the human-readable date on the calendar display
* `loadSize` (Picklist): Options include S, M, and L. This picklist is displayed in each record (each day on the monthly calendar).

  Calendar records (days) can display any number of set-associated fields. The
  administrator should apply a practical limit to the number of fields defined, based on users' screen sizes and responsiveness provided by the application.
{#layout_calendar_display_component__ul_gp4_xrx_chc}

The On Configure/Reconfigure enrichment initializes the set with the appropriate size for the months to be displayed and a JSON element that contains field values for each record. The following is the output of the On Configure
enrichment for the raw calendar above:

    {
    	"availableDates": {
    			"data": [
    			{
    				"availableDate": { "value": "6/1/2024" },
    				"rawDate": {
    				"value": "2024-06-01T00:00:00.000Z"
    				}
    			}, //skipped interior records for brevity
    			{
    				"availableDate": { "value": "6/30/2024" },
    				"rawDate": {
    				"value": "2024-06-30T00:00:00.000Z"
    				}
    			}
    		],
    		"userEdited": false
    	}
    }

Note that the loadSize field was left out of the set JSON because the administrator did not want to prepopulate the field.

In the blueprint layout, the administrator defines where the set will be displayed and the subfields that will be displayed in each record/calendar day.


In the Set Properties \> Selection Settings, the Admin defines whether the user should be allowed to select one or multiple days. The Boolean field for selection (in this case, selectedDate) stores whether a specific set
record/calendar day is selected.


The Set Properties \> Search Settings help you display the most relevant subset of days for the user when your calendar lets the user select from more than one month. For this purpose, Source Field is the day (record) that the
Admin wishes to feature in the monthly calendar set. Target Field is the set-associated field that contains the full range of calendar dates.


The Set Properties \> Raw Value area contains the JSON output by the selections on the page above. However, as "calendar" is not currently selectable as a displayType, the administrator must edit the JSON to define it
explicitly.


