# Property

A custom property definition.

Group: Objects.

## Fields

- `propertyDefId` (string, required): The property's id.
- `key` (string, required): The immutable key spots use in customValues.
- `label` (string, required): The label buyers see.
- `kind` (string, required): The kind; it decides the value's type and whether buyers can filter by it. One of `shortLabel`, `longSection`, `number`, `date`, `checkbox`, `singleSelect`.
- `order` (number, required): Display order (ascending).
- `required` (boolean, optional): true when every spot must carry a value. Absent means false.
- `filterable` (boolean, required): Whether buyers can filter by it (number, date, checkbox and singleSelect).
- `placeholder` (string or null, required): Editor placeholder text.
- `numUnit` (string or null, required): Unit label for number properties.
- `options` (array of objects, required): Options of checkbox and singleSelect properties.
  - `id` (string, required): The option's immutable id: the value spots store.
  - `label` (string, required): The option's label.
  - `order` (number, required): Display order (ascending).
  - `archived` (boolean, required): true when the option is retired; stored values stay.
- `archived` (boolean, required): true when the property is archived; stored values stay.
- `schemaVersion` (number, required): The guide's property schema version after the last change.

## Used by

- [list_properties](https://developers.sceniq.earth/reference/list_properties.md)
- [create_property](https://developers.sceniq.earth/reference/create_property.md)