The ISO 18004 specification: dark on light
The global QR code standard (ISO/IEC 18004) is built on an explicit assumption: the foreground pattern is darker than the background.
This is hardcoded into the geometry of the three corner "finder patterns" (the nested square eyes). A scanner searches image scanlines specifically for a 1:1:3:1:1 pattern of dark-light-dark-light-dark pixels. When you invert the code, that ratio becomes light-dark-light-dark-light, and traditional decoders fail to locate the code entirely.
The scanner divide: who can read inverted codes?
Whether an inverted QR code scans depends entirely on the software running behind the camera:
Scanners that CAN read inverted codes
- Apple iOS Camera: Recent iOS versions run a secondary inversion pass if the primary dark-on-light pass detects no matrix.
- Google Lens / Modern Android: Native Pixel and Samsung camera apps include inverted heuristic passes.
- ZXing / Modern decoders: Libraries with explicit inverted decoding enabled.
Scanners that CANNOT (or struggle)
- In-app browser scanners: Built-in webview cameras inside social and chat apps (WeChat, TikTok, Instagram, banking apps) frequently disable the second pass to save battery and frame rate.
- Laser and fixed industrial scanners: Warehouse and ticket gate imagers are optimized solely for standard polarity.
- Low-light environments: Dual-pass algorithms take up to 3× to 5× longer to lock on.
Can QR codes have colors other than black?
Yes! A QR code does not have to be black and white. Decoders do not see color hues — they convert the incoming camera frames to grayscale luminance. As long as the foreground modules have a significantly lower (or higher) luminance value than the background, the code scans perfectly.
For example, QRacade's Arcade theme uses bright mint green (#2ee6c8) with an obsidian background (#0b0b14), while our Forest theme uses deep emerald (#14532d) against soft mint (#ecfdf5). Every theme is calibrated against luminance threshold algorithms to ensure 100% scannability.
Two safe ways to design for dark mode
1. The "Card Container" method (100% universal compatibility)
If your website, flyer, or app interface is dark, do not invert the QR modules. Instead, place a standard dark-on-light code inside a light-colored card or badge. Ensure there is at least a 4-module quiet zone around the outer modules. The card provides a clean canvas for any scanner, while harmonizing with your dark layout.
2. The "Decoding Neutral" high-contrast palette
If you want a futuristic neon or dark arcade look without a white box, ensure the color combination creates a sharp luminance cliff that passes grayscale thresholding. Never guess: always run the design through a real decoding test before printing or deploying.
Related guides
QR code colors and contrast
How much luminance difference a phone camera needs.
DesignThe quiet zone margin
Why the border around your code prevents edge blend.
DesignWhy won't my QR code scan?
Checklist for troubleshooting color, contrast and lighting issues.
TroubleshootingHow QRacade verifies codes
Why our generator tests every design before download.
BasicsDesign verified custom QR codes
Create beautiful color-themed QR codes with guaranteed contrast and verified scannability: