Why QR Contrast Decides Whether a Code Scans
A QR reader does not see colours the way a person does. It converts the camera image to black and white, then decides which modules are dark and which are light. When the foreground and background are too close in brightness, that decision becomes guesswork, and the code fails even though it looks perfectly clear to the eye. That is why contrast, not taste, is the first thing to check on any branded QR code. A beautiful code that does not scan is not a design choice, it is a broken link printed on paper.
How the ratio works
The WCAG contrast formula compares the relative luminance of the two colours, which is a measure of how bright each colour appears after accounting for how human vision weights red, green, and blue. The result runs from 1:1, meaning identical colours, to 21:1 for pure black on pure white. For QR codes, treat 4.5:1 as your working floor. That number comes from the WCAG AA threshold for normal text, and it is a sensible, conservative bar for a pattern that a phone camera must binarise in uneven light. Between 3:1 and 4.5:1 a code may scan in good light on a good phone and fail everywhere else, so treat that band as a warning, not a pass. Below 3:1, expect failures.
The traps designers fall into
The most common trap is a coloured code on a coloured background where both colours are mid-tone, such as teal on grey or red on green. Hue differences do not rescue a code when luminance is similar, and some colour-blind users and many camera sensors will see even less separation than you do. Another trap is placing a code over a photograph or gradient: the contrast varies across the code, so one corner passes while another fails. A third trap is reversed codes, light on dark. They can work, but many scanners assume a dark code on a light background, so reversed codes need extra testing on several phones and an even stronger ratio.
A practical workflow
- Start from black on white, then introduce brand colour in the foreground only, keeping the background white or near-white.
- If you must colour the background, keep it very pale and keep the quiet zone the same pale colour.
- Check the ratio with this tool, then print a proof at final size and scan it on two different phones, in shade and in bright light.
- For outdoor codes, add margin above the 4.5:1 floor, because sun glare and fading eat contrast over time.
Contrast is cheap insurance. It costs nothing to darken a foreground by a few shades, and it can be the difference between a campaign that converts and a poster that quietly does nothing.