shape

Vector shape — 26 built-in geometries, from a plain rectangle to a heart.

See also

This is the import-time schema. To override an existing shape layer's properties at generation time, see Element Properties → Shape.

Property	Type	Notes
shape	enum	One of the 26 values below. Defaults to rectangle. The field is shape, not type — type is the layer discriminator everywhere else in the payload, so sending it inside properties is rejected with unknown_field.
background_color	color	Fill color. Accepts a gradient — see Colors & Gradients for the token syntax.
pattern_name	string	Name of a repeating fill pattern (1–100 chars) — see the pattern preview grid on the generation-time Element Properties → Shape → Pattern page for all 13 names. Dropped with a warning on printer.
pattern_color	hex color	Pattern ink color. Hex/CMYK only — no gradient. Dropped with a warning on printer. See Color & Length Conventions.
opacity	int	0–100. Defaults to 100.
rotation	float	0–360 inclusive.
stroke	object	{ color, width }. See Shared Object Shapes for ranges.
radius	object | int	{ tl, tr, bl, br } corner radii (rectangles), or one number for all four. See Shared Object Shapes for ranges.
shadow	object	{ blur, offset_x, offset_y, color }. See Shared Object Shapes for ranges.

All 24 shape values — most are self-explanatory geometric names; the ones that aren't are annotated below:

rectangle · triangle · right_triangle (a triangle with one 90° corner) · circle · half_circle (semicircle) · star_1 / star_2 (two star silhouettes — there is no plain star) · pentagon · hexagon · hexagram (six-pointed star, i.e. two overlapping triangles) · rhombus (diamond) · parallelogram · trapeze (trapezoid) · squircle (a rounded-square/circle blend) · curved_diamond (a rhombus with concave curved edges) · window · frame (a picture-frame outline) · arrow · cross · gear · rounded_gear (a gear with rounded, blunted teeth) · blob · cloud · heart

Not shape properties

padding, border and overlay are not accepted on shape — the overlay belongs to image.