QR Codes

Every route in Tolinku can generate a QR code. QR codes are useful for print materials, product packaging, event signage, restaurant menus, and anywhere you want to bridge the physical and digital experience.

Generating a QR code

On the Routes list page, click the QR code icon next to any route.

• Static routes: The QR code is generated immediately using the route’s full URL.
• Dynamic routes: You will be prompted to enter a token first. The QR code is then generated for that specific token (e.g. /invite/abc123).

The QR code is rendered as a 400x400 PNG image. If your Appspace has a logo configured (iOS app icon, Android app icon, or Appspace logo), it appears in the center of the QR code.

URL format

QR codes include a utm_source=qr parameter so you can track QR scans separately in analytics:

https://your-domain.tolinku.com/promo?utm_source=qr
https://your-domain.tolinku.com/invite/abc123?utm_source=qr

Domain requirements

QR codes use your configured domain. Tolinku picks the domain in this order:

1. Your first subdomain (e.g. my-app.tolinku.com)
2. Your first custom domain (e.g. links.yourapp.com)

You can also generate QR codes using your route’s short link by adding ?short=1 to the QR endpoint.

Caution

If no domain is configured for your Appspace, QR code generation will fail. Make sure you have at least one subdomain or custom domain set up.

Tips for print

• Size: The 400x400 output works well for digital use. For print, scale it up to at least 1 inch (2.5 cm) at 300 DPI.
• Contrast: QR codes need high contrast. Print on a light background with dark codes. Avoid placing them on busy or textured surfaces.
• Testing: Always scan the printed QR code with a real phone before distributing. Camera apps, lighting conditions, and print quality all affect readability.
• Quiet zone: Leave white space around the QR code. Most QR readers need a margin of at least 4 modules (the small squares that make up the code) on all sides.