Lightning Types Reference

This section describes the keywords available and the default editor and renderer associated with each of the Lightning types.

The lightning__booleanType Lightning type corresponds to the boolean type in a JSON schema. It produces only two values, true or false.

For Use in

Agentforce Employee agent in Lightning Experience, Agentforce Service agent via Enhanced Chat v2, Prompt Builder, and Experience Builder

lightning__booleanType
Editor DescriptionWhen the type receives user input, it appears as a toggle in the UI.

Default editor example:
A toggle switch indicating that a Boolean property is active.
Renderer DescriptionWhen the type produces output, it’s rendered as a true or false value.

Default Renderer example:
Text displaying the boolean value 'true'.

For information about boolean type, see Understanding JSON Schema: boolean.

The lightning__booleanType Lightning type supports these configurable keywords.

KeywordRequiredTypeDescription
titleYesStringThe label text for the toggle
descriptionNoStringThe help text that describes the toggle’s purpose

The lightning__dateType Lightning type uses a string type to specify the date data in the format yyyy-mm-dd.

For Use in

Agentforce Employee agent in Lightning Experience, Agentforce Service agent via Enhanced Chat v2, Prompt Builder, and Experience Builder

lightning__dateType
Editor DescriptionWhen the type receives user input, it appears as a date picker in the UI.

Default editor example:
A date picker set to February 21, 2025.
Renderer DescriptionWhen the type produces output, it’s rendered as a date data.

Default Renderer example:
The date December 25, 2025.

The lightning__dateType Lightning type supports these configurable keywords.

KeywordRequiredTypeDescription
titleYesStringThe label text for the date field
descriptionNoStringThe help text that explains the purpose of the date selection

The lightning__dateTimeType Lightning type describes the complex Lightning type lightning__objectType, which contains the dateTime and timeZone (optional) properties. Use the Lightning__dateTimeType Lightning type to specify date and time together.

Because lightning__dateTimeType is a standard complex Lightning type, the value of the type is represented as an object.

This table shows the properties of the object type that the lightning_dataTimeType Lightning type describes.

PropertyRequired or OptionalTypeDescription
dateTimeRequiredStringSpecify the date value in yyyy-MM-dd'T'HH:mm:ss.SSSZ format.
timeZoneOptionalStringSpecify the time zone information in IANA time zone database format.

This example shows an object with valid date and time values.

For Use in

Experience Builder

lightning__dateTimeType
Editor DescriptionWhen the type receives user input, it appears as a date picker and a time picker in the UI.

Default editor example:
A form that displays a date, time, and time zone.
Renderer DescriptionWhen the type produces output, it’s rendered as a date and time data.

Default Renderer example:
A timestamp indicating April 11, 2024, at 8:36 PM.

The lightning__dateTimeType Lightning type supports these configurable keywords.

KeywordRequiredTypeDescription
titleYesStringThe label text for the datetime field
descriptionNoStringThe help text that provides context for selecting the date, time, and time zone

The lightning__dateTimeStringType Lightning type describes date, time, and time zone in standard ISO 8601 format. Use the lightning__dateTimeStringType Lightning type to specify date and time together in a standard ISO 8601 format string.

For Use in

Agentforce Employee agent in Lightning Experience, Agentforce Service agent via Enhanced Chat v2, Prompt Builder.

lightning__dateTimeStringType
Editor DescriptionWhen the type receives user input, it appears as a date and time picker in the UI.

Default editor example:
A form with separate input fields for Date and Time.
Renderer DescriptionWhen the type produces output, it’s rendered as a date and time data.

The lightning__dateTimeStringType Lightning type supports these configurable keywords.

KeywordRequiredTypeDescription
titleYesStringThe label text for the datetime field
descriptionNoStringThe help text that provides context for selecting the date, time, and time zone

Use the lightning__integerType Lightning type to specify integers. The type applies to whole numbers. The lightning__integerType Lightning type corresponds to the integer type in a JSON schema.

For Use in

Agentforce Employee agent in Lightning Experience, Agentforce Service agent via Enhanced Chat v2, Prompt Builder, and Experience Builder

lightning__intergerType
Editor DescriptionWhen the type receives user input, it appears as a numeric input field in the UI.

Default editor example:
An integer field with the value 5 entered.
Renderer DescriptionWhen the type produces output, it’s rendered as a number display field.

Default Renderer example:
A text box displaying an integer value of 5.

For information about the integer type in JSON Schema, see Understanding JSON Schema: integer.

The lightning__integerType Lightning type supports these configurable keywords.

KeywordRequiredTypeDescription
maximumNoNumberThe maximum allowed integer value. Input can’t exceed this value.
minimumNoNumberThe minimum allowed integer value. Input lower than this value triggers a validation error.
titleYesStringThe label text for the input field
descriptionNoStringThe help text that describes the expected input

The lightning__multilineTextType Lightning type is similar to Lightning__textType, but it accommodates a larger maximum character length and an editor for larger text input. The lightning__multilineTextType Lightning type corresponds to the string type in a JSON schema.

For Use in

Agentforce Employee agent in Lightning Experience, Agentforce Service agent via Enhanced Chat v2, Prompt Builder, and Experience Builder

lightning__multilineTextType
Editor DescriptionWhen the type receives user input, it appears as a multiline text input field on the UI.

Default editor example:
A multiline text field with sample text entered.
Renderer DescriptionWhen the type produces output, it’s rendered as a multiline text display field.

For information about string types in JSON Schema, see Understanding JSON Schema: string.

The lightning__multilineTextType Lightning type supports these configurable keywords.

KeywordRequiredTypeDescription
maxLengthNoNumberThe maximum number of characters allowed. Input can’t exceed this limit.
minLengthNoNumberThe minimum number of characters required. Input shorter than this limit triggers a validation error.
titleYesStringThe label text for the text area
descriptionNoStringThe help text that provides instructions for the input

Use the lightning__numberType Lightning type to specify numbers. This type is validated as a decimal number, also known as a float in some programming languages. The lightning__numberType Lightning type corresponds to the number type in a JSON schema.

For Use in

Agentforce Employee agent in Lightning Experience, Agentforce Service agent via Enhanced Chat v2, Prompt Builder, and Experience Builder

lightning__numberType
Editor DescriptionWhen the type receives user input, it appears as a decimal number input field in the UI.

Default editor example:
A decimal number field with the value 1.32 entered.
Renderer DescriptionWhen the type produces output, it’s rendered as a decimal number display field.

Default Renderer example:
A text box displaying a decimal number value of 15.15.

For information about number type in JSON Schema, see Understanding JSON Schema: number.

The lightning__numberType Lightning type supports these configurable keywords.

KeywordRequiredTypeDescription
maximumNoNumberThe maximum allowed numeric value. Input can’t exceed this value.
minimumNoNumberThe minimum allowed numeric value. Input lower than this value triggers a validation error.
multipleOfNoNumberThe step value for increasing or decreasing the number. If not specified, the default is 1.0E-32.
titleYesStringThe label text for the input field
descriptionNoStringThe help text that describes the expected input, such as the unit of measurement

Use the lightning__objectType lightning type to create object lightning types. This complex Lightning type can contain sub-properties, each with its own Lightning type.

With lightning__objectType, you can group other lightning types. The lightning__objectType lightning type corresponds to the object type defined in a JSON schema.

For information about object types in JSON Schema, see Understanding JSON Schema: object.

For Use in

Agentforce Employee agent in Lightning Experience, Agentforce Service agent via Enhanced Chat v2, Prompt Builder, and Experience Builder

Use the lightning__richTextType Lightning type to add, edit, and delete rich text data. You can enter input text data of up to 100,000 characters.

For Use in

Agentforce Employee agent in Lightning Experience, Agentforce Service agent via Enhanced Chat v2, Prompt Builder, and Experience Builder

lightning__richTextType
Editor DescriptionWhen the type receives user input, it appears as a rich text input field in the UI.

Default editor example:
A rich text editor with formatting options and a sample text box.
Renderer DescriptionWhen the type produces output, it’s rendered as a rich text display field.

For information about rich text editor, see Rich Text Editor.

The lightning__richTextType Lightning type supports these configurable keywords.

KeywordRequiredTypeDescription
maxLengthNoNumberThe maximum number of characters allowed
minLengthNoNumberThe minimum number of characters required (including HTML markup)
titleYesStringThe label text for the rich text editor
descriptionNoStringThe help text that describes the expected content or formatting

Use the lightning__textType Lightning type for text fields, such as titles and descriptions. You can enter input text data of up to 255 characters. The lightning__textType Lightning type corresponds to the string type in a JSON schema.

For Use in

Agentforce Employee agent in Lightning Experience, Agentforce Service agent via Enhanced Chat v2, Prompt Builder, and Experience Builder

lightning__textType
Editor DescriptionWhen the type receives user input, it appears as a text input field on the UI.

Default editor example:
A text field with sample text entered.
Renderer DescriptionWhen the type produces output, it’s rendered as a text display field.

Default Renderer example:
A text box displaying sample text.

The lightning__textType Lightning type supports these configurable keywords.

KeywordRequiredTypeDescription
maxLengthNoNumberThe maximum number of characters allowed
minLengthNoNumberThe minimum number of characters required
titleYesStringThe label text for the text field
descriptionNoStringThe help text that describes the expected input

Use the lightning__timeType Lightning type for time-specific fields, such as appointment time or arrival time. You can input time using the format HH:MM:SS.000Z (UTC) or HH:MM:SS. The format includes hours, minutes, seconds, and optional milliseconds.

For Use in

Agentforce Employee agent in Lightning Experience, Agentforce Service agent via Enhanced Chat v2 and Prompt Builder

lightning__timeType
Editor DescriptionWhen the type receives user input, it appears as a time picker in the UI.

Default editor example:
A time input field labeled 'Enter time' populated with the value 23:58:27@586.
Renderer DescriptionWhen the type produces output, it’s rendered as a time string displayed.

Default Renderer example:
The text value 21:11:28~185Z displayed on screen.

The lightning__timeType Lightning type supports these configurable keywords.

KeywordRequiredTypeDescription
titleYesStringThe label text for the time field
descriptionNoStringThe help text that explains the purpose of the time selection

Use the lightning__urlType Lightning type for URL values. To specify the url schemes that the type can validate against, configure lightning:allowedUrlSchemes parameter of the Lightning type.

For Use in

Agentforce Employee agent in Lightning Experience, Agentforce Service agent via Enhanced Chat v2, Prompt Builder, and Experience Builder

lightning__urlType
Editor DescriptionWhen the type receives user input, it appears as a URL input field in the UI.

Default editor example:
A field with a sample URL entered.
Renderer DescriptionWhen the type produces output, it’s rendered as a hyperlink.

The lightning__urlType Lightning type supports these configurable keywords.

KeywordRequiredTypeDescription
lightning:allowedUrlSchemesNoString[]An array of supported URL schemes, such as https, http, or mailto
titleYesStringThe label text for the URL field
descriptionNoStringThe help text that describes the expected URL format