Handbook · Reference · DataRefs

DataRef kinds

Where in the UI. Layout value source, fieldBindings, editFilter watches, action targets.

KindPoints atStoreRead/write
itemFieldBuilt-in item columnCurrent item’s SQLite/row fields listed in Item fields.Read/write except createdAt (read-only).
indexedItemFieldimageUris[n]Nth gallery photo on the item.Write replaces that slot.
categoryPropertyCategory valueProperty owned by a category. Must use the owning categoryId. Optional itemFrom itemVariable to read another item.Read/write if scriptWritable allows writes from scripts.
computedComputed definitionNamed derived value on the template.Read-only.
localStateSession slotTemporary key for the open session.Read/write; not persisted as item data.
runtimeContextHost contextcurrentDateTime, currentUserId, privacyLevel, authState, canvasScale, canvasMode, colorScheme.Read-only.
itemMetricLazy metricCounts and flags (children, images, graph degree, fill rates, descendant timestamps…).Read-only.
expressionExpression libraryEvaluate another named expression.Read-only result.
itemVariableItem variableKey in itemVariablesJson. Scripts create/update keys.Read/write via scripts and some bindings.
themeColorTheme tokenApp chrome or item-default theme colors, with auto/light/dark mode.Read-only.
itemHasClassMembershipWhether the item (or ancestor) has a class.Read-only.
itemHasCategoryMembershipWhether the item has a category id.Read-only.
itemHasElementMembershipWhether the item’s element id matches.Read-only.

Localized template strings are not a DataRef. Button labels, Containd text in Blockly, and chrome copy live in the translations matrix. You bind fields and properties; you translate strings. Source: containd/.../v2/types/binding.ts DataRef.