QR codes · 5 November 2026

Why Your QR Code Will Not Scan (and How to Fix It)

The usual reasons QR codes fail on posters, menus and cards, with simple fixes.

You printed two hundred flyers and the QR code will not scan. Almost always the cause is one of a handful of simple things.

Low contrast

Scanners need a dark code on a light background. Light grey on white, or a pale colour on a photo, will not work. Black on white is boring and reliable. If you want colour, keep the code much darker than the background. The QR Code Generator lets you change both colours, so test any pairing you try.

Too much data

The longer the text, the more squares the code needs, and the harder it is to read at a small size. A short link scans faster than a long one with tracking parameters. If your link is long, use a short redirect link.

Too small, or too blurry

A good rule is a code at least 2 cm across for a phone held at hand's length, and bigger for something on a wall. Download the PNG at a large size for printing, or use the SVG, which never gets blurry.

Missing quiet zone

Every QR code needs a blank border around it, about four squares wide. If you crop it tight or put it right next to a coloured edge, scanning fails. Our codes include that margin; do not trim it off.

Inverted or stretched

Do not stretch the code to fit a layout, and do not invert the colours. Some scanners cannot read light-on-dark codes.

Test like a customer

  • Scan with two different phones, ideally an older one.
  • Test it in the light where it will hang.
  • Do this before you print a thousand copies.

For WiFi and payments, double check the details. The UPI QR generator encodes exactly the ID you type, so a typo means money goes to the wrong person.

Tools mentioned in this article