Layer Types
Every layer in a Create Import payload declares a type, and its properties shape depends on that type. All enums below are strictly validated; unknown values are rejected with unknown_enum_value. Enum values are case-sensitive — use them exactly as written (e.g. unit: "mm", not "MM"). The only case-insensitive strings are color tokens.
All layers also support the layer-level hidden and locked flags (see Create Import → Per-format visibility).
Two of these are animated-only
video and audio exist on type: "animated" designs alone. On any other design type they are rejected with unknown_enum_value, since each type accepts its own set of layer types.
Colors and lengths
Every color and hex color property on the pages below follows this rule:
static / animated | printer / printer_multipage | |
|---|---|---|
| Colors | #RRGGBB or #RRGGBBAA | cmyk() / cmyka() tokens — a solid hex is converted for you, a gradient is rejected |
| Lengths | Integer pixels | Floats in the format's unit |
| Font sizes | Pixels | Points |
Full token grammar: Colors & Gradients. The printer-specific rules, including the properties print cannot render at all: Print Imports.
Shared object shapes
Several properties are nested objects with the same shape across layer types. On static / animated their lengths are integer pixels; on printer they are floats in the format's unit.
shadow/text_shadow={ blur, offset_x, offset_y, color }—blur0–200,offset_x/offset_y−200–200.stroke={ color, width }—width0–1000.radius={ tl, tr, bl, br }(image / logo / shape) or a single number for all four corners; each corner 0–1000. A button'sradiusis a number only — the editor stores one scalar for it.padding={ vertical, horizontal }or a single number for both; both fields required. Onstatic/animatedeach is an integer −1000–1000 — negative values are legal and pull the text background box inside the glyph run. Onprinterthey are floats in the format'sunit, also signed and with no bound. Top and bottom cannot differ, nor left and right — the editor holds one value per axis.
Two contexts for the same layer kinds
This page describes the import-time schema — the full shape you author when creating a design from scratch. Once a design exists, Generation → Element Properties describes the smaller set of fields you can override at generation time. See Layers overview for how the two relate.