Handbook · Reference · Category properties

Category property types

Where in the UI. Structure inspector on a Category property node.

Shared knobs on every property: name, description, default, min/max/pattern, enum values, table schema, aiLookup, scriptWritable, UI hints. Bindings must use the owning category id. Children inherit ancestor properties and should only add deltas.

The list type is on the TypeScript union; the editor’s category import allowlist currently omits it, so a JSON round-trip may drop list properties. Prefer table when you need columns.

TypeNameUse
textSingle-line textNames, SKUs, short labels.
multilineMultiline textNotes and longer copy.
integerIntegerCounts. Supports min/max.
floatDecimal numberMeasurements. Supports min/max.
booleanBooleanOn/off flags.
dateDateCalendar day without time.
datetimeDate and timeISO timestamp.
colorColorHex/rgba for fills and chips.
urlURLLinks; pattern validation allowed.
emailEmailAddress with format check.
phonePhoneDialable string.
enumEnumFixed options (id, label, optional color/icon).
imageImagePicture stored with the item’s category value.
jsonJSONStructured blob. Prefer tables when rows are the model.
listListRepeated scalar values. Present on the PropertyType union; the editor’s category import allowlist currently omits list, so JSON round-trip may drop it. Prefer table when you need columns.
tableTable (CTBL)Fixed columns, maxRows, rolling or destructive overflow. Compact binary table.
fileTableFile table (CSV)Same columns, unbounded CSV parts on disk. No maxRows.

Source: containd/.../v2/types/category.ts PropertyType.