Skip to content

QR Code

A QR code element renders a scannable QR code from any string payload — typically a URL. You can optionally overlay a centered icon image for branding (e.g. a company logo).

The QR code uses a fixed high error-correction level to ensure scannability even when an icon covers part of the code. If image_url is set, the icon is shown automatically; set hide_icon: true to remove it without removing the URL from the layer configuration.

Available Properties

PropertyDescription
payloadString. Content encoded in the QR code
background_colorBackground color. Monochrome hex or cmyka (print)
foreground_colorForeground color (the squares). Monochrome hex or cmyka (print)
image_urlHTTP(s) URL of an icon displayed in the middle of the QR code. Max 10 MB. Supported: jpeg, png, webp, svg, gif
hide_iconBoolean. Hides the icon if true

Example

json
{
  "payload": "https://mycompany.com/landing",
  "background_color": "#f0f4ff",
  "foreground_color": "#1b4550"
}

QR code example

With icon:

json
{
  "payload": "https://mycompany.com/landing",
  "background_color": "#fdfdfd",
  "foreground_color": "#750000",
  "image_url": "https://mycompany.com/icon.jpeg"
}

QR code with icon example