Binding an object to data

A data-bound object does not hold a literal value — it holds a reference to a schema field. At render time, the object's value comes from the dataset that the production supplies.

When to bind

• The same template should render many different values (player names, scores, captions).
• Operators will change the value live without editing the template.
• The value comes from an imported data source (Excel, CSV, plugin).

Steps

1. Select an object on the design area.
2. Open the Data tab in the properties panel.
3. Pick a schema (for example "player").
4. Pick a field (for example name).
5. Save.

The object now shows a preview value from the dataset. If no dataset is attached yet, it shows the schema's default or a placeholder.

Unbinding

Open the Data tab and clear the binding. The object falls back to its literal value (the Text field for text, the uploaded image for images).

Which objects can be bound?

• Text → any scalar field (text, number, boolean).
• Image → any field whose value is an asset path.
• Icon → any field whose value is an icon name.
• Countdown → a field whose value is a date or duration.

Rectangles and ellipses cannot be bound directly, but their fill color can be bound via styling rules.