Experiences Reference Overview

This section contains reference documentation for Ligantic Experience schemas and block types.

Scope

Experience reference documentation covers:

• Experience content schema structure
• Block type schemas and per-block configuration
• Shared style/layout/data-binding properties used by blocks
• Block state configuration and availability

Entry Points

• Experience Blocks Reference
• Experience States and Print Layout

Datum Reference Date Formatting

When a datum reference points to a date field, the value is automatically formatted using the following cascade:

1. Reference-level format — optional date format set on the datum reference overrides the field default
2. Field-level defaultFormat — from the schema field's configuration
3. ISO fallback — raw string value if no format is configured

The timezoneDisplay setting on the Schema field controls whether dates are shown in the stored (source) timezone or converted to the viewer's timezone, including custom date patterns.

See Schema Field Types Reference — date for format preset and custom pattern details.

Dangling Datum References

A datum reference is dangling when the datum it points to no longer exists — for example, the block that provides it (such as a forEach) was deleted in the Experience designer after the reference was saved.

Dangling references do not stop the Experience from displaying:

• Published Experiences — the block renders its fallback (for example, fallbackText, or the variable node's defaultValue for variables in content) and the Experience remains viewable.
• Experience designer — the block renders the same fallback. The block is also surfaced with a needs setup overlay, the same treatment as unconfigured Button blocks and unconnected Input blocks: an orange dashed border is always shown, and the ⚙ Datum reference missing badge appears while the block (or anything inside it) is hovered on the canvas or in the Layers panel, or while it is selected.