BlocksMedia & Design
Generate QR Code
Create a QR code image from text or a URL.
The Generate QR Code block allows you to instantly create QR codes from any text or URL. These codes are generated as high-quality images that can be used for marketing, authentication, or linking to external resources.
Core Concept
Think of a QR code as a digital fingerprint for your data. It packs complex information into a grid of squares that cameras can quickly scan and translate back into its original form.
Configuration
| Field | Required | Description |
|---|---|---|
| Text / URL | ✅ | The data you want to encode (e.g., a link to your website or a piece of text). Max 2000 characters. |
| Width (px) | ✅ | The pixel width of the resulting image. Supports values from 10 to 5000. |
| Margin (Modules) | — | The thickness of the white "quiet zone" around the code. Default is 4. |
| Output Format | ✅ | Choose between PNG image format. |
| Error Correction | — | Determines how much damage the code can sustain while remaining readable. Options: Low (7%), Medium (15%), Quartile (25%), High (30%). |
| Foreground Color (Dark) | — | The color of the QR squares. Supports Hex/RGBA (e.g., #000000ff). |
| Background Color (Light) | — | The color of the background. Use #00000000 for a transparent background. |
| Output Variable | ✅ | The name of the variable where the resulting Base64 string of the image will be stored. |
Hosting the QR Code
The block output is a raw Base64 string. To share it as a public link, connect this block to a Host Media block.
Error Handling
DATA_MISSING— Triggered when no text or URL is provided.DATA_TOO_LONG— Triggered if the input exceeds the 2000-character limit.INVALID_WIDTH— Triggered when the width is outside the allowed range (10–5000px).GENERATION_FAILED— Triggered if the QR generation fails unexpectedly.
Example
- Text / URL:
https://my-awesome-api.com/signup?ref={request.body.user_id} - Width:
400 - Foreground Color:
#1a73e8(A nice brand blue) - Output Variable:
user_qr_code
Result: The variable {user_qr_code} will contain a Base64 encoded PNG of the QR code. You can then use this string in an email or host it to get a public URL.