Primitive Data Types

Primitive data types are the building blocks for component data. They represent simple values like text, numbers, and booleans.

Text

The text data type accepts string values with optional validation constraints. These ensure data quality and guide users toward valid input.

Note: Specify these additional configurations under a text field in your data item.

maxLengthint32

Maximum number of characters allowed.


minLengthint32

Minimum number of characters required.


patternstring

Regular expression pattern the text must match.

Note: If you set a defaultValue, it populates the panel's text input when the component is first added. If a Wix user then deletes the text, the field remains empty, it doesn't revert to the default.

Example

A text field with validation constraints:

In the manifest:

Copy

In the component:

Copy

Guid

The guid data type represents a globally unique identifier (GUID/UUID). No additional configuration is needed.

Example

A GUID field for unique identification:

In the manifest:

Copy

In the component:

Copy

Number

The number data type accepts numeric values with optional validation constraints. Useful for ensuring values stay within acceptable ranges.

Note: Specify these additional configurations under a number field in your data item.

minstring

Minimum allowed value.


maxstring

Maximum allowed value.


multiplierstring

Multiplier applied to the value.

All 3 fields are optional, and all 3 take strings rather than numbers. Set them when the value has a meaningful range, so the editor can render a bounded control instead of an open number input.

Note: These constraints and the item's defaultValue configure the editor panel. They don't reach your component. Give every numeric prop a default in your component code, so it has a value to render before a Wix user sets one. For more information, see Default values and runtime fallbacks.

Example

A rating field with min and max constraints:

In the manifest:

Copy

In the component:

Copy

Boolean value

The booleanValue data type represents true or false values.

Example

A feature toggle field:

In the manifest:

Copy

In the component:

Copy

See also

Last updated: 2 November 2026

Did this help?