Image objects

An image object renders a picture from the project's assets or from a URL.

Where the image comes from

• Upload — picks an image already in the project's assets. See Media Assets for how uploads work.
• Binding — the object's source is a schema field whose value is an asset URL. Every row of a dataset can point at a different image (player photos, team logos).

When bound, set a fallback image to render when the row has no value.

Key properties

• Width, height, X, Y.
• Fit — how the image fills the box:
  • Contain — fits inside, shows empty space if the aspect ratio differs.
  • Cover — fills the box, crops the image if aspect ratio differs.
  • Stretch — stretches the image to match the box (can distort).
• Opacity, rounded corners, border, shadow — all apply.

Performance

The renderer caches images, but very large uploads slow down the first frame. Resize uploads to at most 2× the object's pixel size to keep rendering snappy.

Transparent backgrounds

PNG and WebP with an alpha channel are preserved. Avoid JPEG for logos or anything that needs transparency.