Scannability best practices

A QR code only does its job if it scans on the first try, every time. These are the rules that matter, in priority order.

1. Contrast is king

Scanners read the difference between dots and background. Keep it strong:

• Safest: dark dots on a light background.
• Light-on-dark works but test it.
• Avoid low-contrast pairs (yellow on white, light grey on white).
• Keep gradients subtle enough that the lightest stop still contrasts with the background.

2. Keep the quiet zone

Leave an empty margin around the code so scanners can find its edges. Don't crop to the dots — a small quiet zone hugely improves reliability, especially on busy backgrounds.

3. Protect the eyes

The three corner squares (finder patterns) let scanners orient the code. Keep them clean, high-contrast, and never cover them with a logo or text.

4. Size it for the scan distance

• Bigger codes scan from farther away and tolerate more wear.
• Rough floor for close scanning: ~2 × 2 cm (0.8 in).
• Scale up for posters, shelf signage, and anything read from a distance.

5. Keep logos modest

A center logo around 15–25% of the width is safe. Larger logos eat the error-correction budget that protects against real-world wear. See How to add a logo.

6. Pick the right file format

• SVG for print (never pixelates).
• PNG for screens.
• Avoid JPEG for small codes — compression softens dot edges. See How to download a QR code.

7. Mind the surface

• Avoid glossy spots that reflect glare onto the code.
• On curved surfaces (bottles, cups), keep the code small enough to stay flat-ish and test it.
• Matte materials scan more reliably than high-gloss.

8. Always test before printing in bulk

Scan the final asset with two or three phones (iOS + Android) under normal light. Fix any hesitation before you commit to a print run.

FAQ

What's the most common scannability mistake? Low contrast and missing quiet-zone margin, followed by oversized logos.

Do artistic QR codes follow the same rules? Yes — even AI-art codes need contrast, clean eyes, and testing. See AI-art QR codes that still scan.

---

Next: Why did my QR code stop working? · QR error correction explained