Creating QR Codes

Last updated: December 16, 2025

QR Igniter generates GS1 Digital Link compliant QR codes that encode product information and link to destination URLs. This guide covers all QR code creation options.

Creating a QR Code

  1. Navigate to QR Codes in the admin sidebar
  2. Click the New QR Code button
  3. Fill in the GS1 fields and settings
  4. Click Create

GS1 Fields

Field AI Code Required Description
Campaign - Yes Parent campaign
GTIN 01 Yes 14-digit Global Trade Item Number
Batch/Lot 10 No Batch or lot number
Serial Number 21 No Unique serial identifier
Expiry Date 17 No Product expiry (YYMMDD format)
CPV 22 No Consumer Product Variant

Destination Settings

Field Required Description
Destination URL Yes Where users are redirected after scanning
Use Interim Selector No Show selection page with multiple link options
Status Yes Active or Inactive

QR Code Levels

QR codes can operate at different identification levels:

Level Fields Used Use Case
Product Level GTIN only Same QR for all units of a product
Batch Level GTIN + Batch/Lot Track by production batch
Serialized Level GTIN + Serial Unique QR per individual unit

Styling Studio

Every QR code can be fully styled, with a live preview that updates as you change the controls. Start from a one-click preset, then fine-tune:

Option Choices
Style preset Classic, Modern, Gradient, Dots, Diamond, Dark, Retro, Nature
Module shape Square, Dots, Rounded, Extra Rounded, Classy
Eye frame & centre Square, Rounded, Extra Rounded, Circle (set independently) + optional eye colour
Colours Foreground, background, transparent background
Gradient None, Vertical, Horizontal, Diagonal, Radial (+ end colour)
Quiet zone 0–10 modules of margin
Frame / caption Optional bordered frame with configurable colour & thickness and a call-to-action caption (e.g. “SCAN ME”) that auto-contrasts the frame colour
Generated automatically

The QR image is generated for you the moment you save — there is no file to upload. Gradients render in full in the SVG/print formats; PNG uses a solid colour where a gradient isn’t supported.

Logo Embedding

Brand logos can be embedded in QR codes:

  1. Ensure the brand has a logo uploaded (or upload a custom logo for this code)
  2. Enable "Embed Brand Logo" when creating the QR code
  3. The system automatically uses H-level error correction
  4. Set the Logo Size (10–35%) and toggle Clear behind logo
Logo Size & Punch-out

The Logo Size control sets the logo to 10–35% of the QR code centre. Leave Clear behind logo on (the default) to clear the QR modules behind the logo with a clean rounded box, which keeps larger logos scannable. Both are reflected in the live preview.

Download Formats

QR codes can be downloaded in multiple formats:

Format Use Case
PNG Digital displays, websites, apps
SVG Scalable graphics, large format printing
EPS Professional print production
PDF Print-ready document output

Pass ?format=png|svg|eps|pdf to the download endpoint, or set the default download format per code in the studio.

Interim Selector

The interim selector provides multiple destination options from a single QR code:

  • Product Information
  • Recipes & Usage Instructions
  • Contact Support
  • Enter Competition
  • Social Media Links

Link Icons

Each resolver link can carry an icon. Choose Icon to pick a Heroicon from a searchable visual grid, or switch to Emoji and paste a single glyph. Heroicons render as crisp inline graphics on the selector page (matching the button text colour); emoji render as-is.

Page Branding

The interim selector page is fully brandable. The Interim Page Branding section — available on the brand, campaign and QR code forms — lets you set the heading, subtitle, logo, header banner image, background colour (and an optional gradient end), card colour, text colour, button colour, button text colour, accent colour and footer text.

Branding cascade

Branding cascades brand → campaign → QR code: set it once on the brand and it applies everywhere, then override individual fields on a campaign or a single QR code. Leave a field blank to inherit from the level above. Buttons are uniform full width.

Generated Digital Link

Example of a generated GS1 Digital Link URI:

https://qr2.ignited.cloud/01/09506000134352/10/BATCH123/21/SERIAL456?17=251231

API Access

# Create QR code
POST /api/v1/qr-codes
{
    "campaign_id": 1,
    "gtin": "09506000134352",
    "batch_lot": "BATCH123",
    "serial_number": "SERIAL456",
    "destination_url": "https://example.com/product",
    "embed_logo": true,
    "logo_size_percent": 22,
    "logo_punchout": true,
    "status": "active"
}

# Download QR code image
GET /api/v1/qr-codes/{id}/download?format=png&size=large

Next Steps