Skip to content

Root

The root element customises the background of your image.

PropertyDescription
background_color3 filling modes: Monochrome, Linear gradient, or Cmyka (print only)

Monochrome Color

Supported formats:

  • 6 hex digits prefixed with #: #RRGGBB — e.g. #0000FF
  • 8 hex digits prefixed with #: #RRGGBBAA — includes alpha — e.g. #0000FF80 (blue at 50% opacity)

Monochrome background example

Opacity reference:

Opacity (0–100)Alpha hex
000
50D
101A
2033
304D
4066
5080
6099
70B3
80CC
90E6
100FF

WARNING

3-digit hex colors (e.g. #AAA) are not supported.

Linear Gradient

Can be used as background_color (banner background, button) or color (text).

Format:

linear-gradient(x1% y1% x2% y2%,offset1% #color1 opacity1,offset2% #color2 opacity2)
ParameterDescription
x1, y1, x2, y2Percentages defining the gradient direction line
offset_color1, offset_color2Start/end offsets (default: 0%, 100%)
hexa_color1, hexa_color26-digit hex start/end colors
opacity_color1, opacity_color2Float 0–1, opacity of each color

Examples:

ValueResult
"background_color": "linear-gradient(0% 0% 100% 0%,0% #1a47ff 1,100% #b65151 1)"Linear gradient horizontal
"background_color": "linear-gradient(0% 0% 0% 100%,0% #1a47ff 1,100% #b65151 1)"Linear gradient vertical
"background_color": "linear-gradient(0% 0% 100% 100%,0% #1a47ff 1,100% #b65151 1)"Linear gradient diagonal

Cmyk / Cmyka Color

Used for print designs only. Two formats are accepted:

  • cmyk(c,m,y,k) — 4 values, each 0–100. Fully opaque. Example: cmyk(0,0,0,0)
  • cmyka(c,m,y,k,t) — 5 values, adds alpha transparency (0–100). Example: cmyka(0,0,0,0,100)

Both function names are valid. cmyk() is equivalent to cmyka() with alpha set to 100 (fully opaque).