A scanner sees light and dark, not colour
When a QR code is read, the image is converted to black and white: every module is judged simply on how bright it is. Hue barely matters. What matters is contrast — your "dark" modules must be clearly darker than your "light" ones, in brightness terms.
The classic arrangement is dark modules on a light background: dark blue on white, black on white, or deep green on cream. As long as the dark modules are genuinely dark and the light ones genuinely light, colour is fine.
The inverted-code trap
A "light on dark" code — pale modules on a black background — looks striking, and many phone cameras handle it. But support is not universal, and some scanners simply refuse an inverted code. If you invert, always test on several devices before you commit, and prefer an inverting-safe design where you can. Print is less forgiving than a phone screen.
Contrast rules of thumb
- Dark on light is the safe default.
- Keep a strong brightness difference: if you squint and the two colours blur together, so will a camera.
- Avoid low-contrast pairs — pale yellow on white, mid-grey on light blue, light green on cream. They read as "all light".
- Keep the quiet zone the same colour as the light modules.
- Don't rely on red/green distinctions; scanners are effectively colour-blind.
Decoration changes the maths
When you re-colour part of a code — say, a logo's surroundings or an animated corridor — you're using the same brightness trick. A decoder-neutral change is one that shifts hue but keeps brightness on the same side of the black/white threshold. Change the brightness and you've actually altered the code, spending its error-correction budget.
Why QRacade uses preset themes
Rather than let you pick any two colours and hope, QRacade offers preset themes that have been contrast-checked and confirmed scannable. You still get to match your brand — you just can't accidentally choose a combination that breaks the code. The verification step then decodes the result to prove it.
Related guides
Inverted QR codes & dark mode
Why white-on-black fails and how to style dark themes safely.
DesignThe QR code quiet zone
Keep the margin the same colour as the light modules.
DesignAnimated QR codes
How decode-neutral re-tinting works.
AnimationWhy won't my QR code scan?
Contrast is one of the first things to check.
TroubleshootingTry a safe theme
Pick from contrast-checked themes in the QRacade generator, or on the logo tool.