QR Code Branding

Design QR codes that match your brand by creating reusable templates.

1. Create a design template

   curl -X POST https://xqr.co/api/v1/qr/templates \
     -H "Authorization: Bearer $XQR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "Brand Purple",
       "design": {
         "foreground_color": "#8B5CF6",
         "background_color": "#FFFFFF",
         "error_correction": "H",
         "dot_style": "rounded",
         "corner_style": "rounded",
         "quiet_zone": 2
       }
     }'

2. Add a logo (optional)

   Upload your logo as an asset, publish it to CDN, then reference it:

   {
     "design": {
       "logo_url": "https://cdn.xqr.co/tenants/.../logo.png",
       "logo_size": 0.25
     }
   }

3. Generate QR codes using the template

   curl "https://xqr.co/api/v1/qr/templates/${TEMPLATE_ID}/render?data=https://example.com&format=png&size=30" \
     -H "Authorization: Bearer $XQR_API_KEY" \
     -o branded-qr.png

4. Reuse across all links

   When generating QR for any link, pass the template ID:

   curl "https://xqr.co/api/v1/links/${LINK_ID}/qr?template_id=${TEMPLATE_ID}&format=png" \
     -H "Authorization: Bearer $XQR_API_KEY" \
     -o link-qr.png

Design Tips

• Use error correction level H (30%) when adding a logo — it ensures the QR remains scannable
• Keep logo size at 25% or less of the QR area
• Ensure sufficient contrast between foreground and background colors
• Test scannability on multiple devices before printing