Common Element Properties
Every visual element (TEXT, IMAGE, VIDEO, GIF, and the deprecated SVG)
shares the same placement, timing, and layering fields. This page is the
canonical reference for those shared properties — element pages document only
what is specific to their type and link back here.
Visual elements belong in payload.visuals or payload.scenes[n].visuals.
Timing and animation fields below are for video projects; image projects use
always-visible static elements and reject timing fields.
Placement & Transform
| Property | Type | Default | Notes |
|---|---|---|---|
x, y | number | 0 | Pixel position. Ignored when a position preset is used. |
width, height | number | auto (source / computed) | Element size in pixels. Limited by plan input resolution for media. |
position | PositionPreset | custom | 9-grid preset placement such as center-center. See PositionPreset. |
anchor | Anchor | derived from position when preset is used | Transform origin for placement and rotation. See Anchor. |
opacity | number | 1 | 0 (invisible) to 1 (opaque). |
angle | number | 0 | Rotation in degrees, -360 to 360, around the anchor. |
flipV, flipH | boolean | false | Vertical / horizontal mirroring. |
With custom coordinates, omitted anchor uses top-left. All sizes and
positions are pixels on the output canvas, not CSS percentages. A preset
overrides explicit x/y; for an inset or margin, use custom coordinates.
See Layout for worked positioning examples.
Timing
All times are seconds on the element's timeline — the project timeline, or the scene-local timeline when the element lives inside a scene. Inside a scene, duration-based defaults refer to that scene's resolved length. For source trimming and automatic duration, see Timing.
| Property | Default | Notes |
|---|---|---|
enterBegin | 0 | Element starts appearing. |
enterEnd | 0 | Element is fully visible. |
exitBegin | project.duration | Element starts disappearing. |
exitEnd | project.duration | Element is fully gone. |
The element is invisible before enterBegin, animates in until enterEnd,
stays visible until exitBegin, and animates out until exitEnd. The
enter/exit windows only have an effect when paired with an
enterAnimation / exitAnimation; with no animation the
element simply cuts in at enterBegin and out at exitEnd.
Layering
| Property | Default | Notes |
|---|---|---|
track | 0 | Z-order: higher tracks render above lower tracks. Inside scenes, scene elements always render below project-level (global overlay) visuals. |
Animations
| Property | Default | Notes |
|---|---|---|
enterAnimation | null | Xfade effect name for the enter window. See Animations. |
exitAnimation | null | Xfade effect name for the exit window. |
Supported effect names are listed in XFadeEffect.
Media-Only Properties
Media elements add resizing and effect options. Support by type:
| Property | IMAGE | VIDEO | GIF | TEXT | SVG (deprecated) |
|---|---|---|---|---|---|
resize (contain/cover) | ✅ | ✅ | ✅ | — | — |
zoom (Ken Burns) | ✅ | ✅ | ✅ | — | — |
filter | ✅ | ✅ | ✅ | — | ✅ |
cropParams | ✅ | ✅ | ✅ | — | — |
chromaKey | ✅ | ✅ | ✅ | — | ✅ |
radius | ✅ | ✅ | ✅ | — | — |
TEXT elements style themselves with style and customCode
instead — rounded corners, shadows, and filters are all regular CSS there.
Audio Timing Is Different
Audio items are not visual elements: they use enter /
exit for timeline placement and audioBegin / audioEnd for source trimming,
and have no transform, layering, or animation fields.