Skip to main content

Creating QR Codes

Click the Create QR Code button on the QR Codes list page to open the creation dialog.

📸
Screenshot: Create QR Code dialog showing label field, prefilled message textarea with character counter, and QR image format dropdown
create-qr-code-dialog.png
1. Click "Create QR Code" button
2. Fill in the label and prefilled message fields
3. Capture the full dialog
Save to: static/img/screenshots/qr-codes/create-qr-code-dialog.png

Form fields​

FieldRequiredDescription
LabelNoA friendly name to identify the QR code (e.g., "Cyber Monday Sale") — max 100 characters. Must be unique across all your QR codes.
Prefilled MessageYesThe message that auto-populates when a customer scans the QR code — max 140 characters. A live character counter is shown below the field.
QR Image FormatNoChoose SVG (recommended for print) or PNG. Defaults to SVG. Only shown during creation — cannot be changed later.
tip

Write prefilled messages from the customer's perspective — they should read naturally as something the customer would say. For example: "Hi! I saw your Cyber Monday offer and I'd like to learn more."


Step by step​

  1. Click Create QR Code in the top-right corner of the QR Codes page
  2. Enter a Label (optional but recommended for easy identification)
  3. Type the Prefilled Message — keep it under 140 characters
  4. Select the QR Image Format (SVG or PNG)
  5. Click Create

After creation​

Once the QR code is created successfully, a success screen appears with:

  • QR code preview — a visual preview of the generated QR code
  • Short link — the wa.me/message/... URL with a Copy Link button
  • Download buttons — download the QR code image in SVG or PNG format
📸
Screenshot: QR Code Created success screen showing QR code preview, short link with copy button, and download SVG/PNG buttons
qr-code-success.png
1. Create a new QR code
2. Capture the success screen showing the QR preview, short link, and download buttons
Save to: static/img/screenshots/qr-codes/qr-code-success.png

Click Done to close the dialog and return to the list.


Label uniqueness​

Each QR code label must be unique (case-insensitive). If you try to create a QR code with a label that already exists, you'll see the error: "A QR code with this label already exists".


Tips​

  • Use descriptive labels — labels help you identify QR codes at a glance (e.g., "Store Front Window", "Business Card - John")
  • Keep messages short and clear — customers can edit the message before sending, but a concise prefilled message sets the right context
  • Choose SVG for print — SVG images scale to any size without losing quality, making them ideal for posters, banners, and packaging
  • Choose PNG for digital — PNG works well for websites, emails, and social media posts