QR Code Guide

How to Customize QR Code Colors

5 min read · FREE QR 360 Team

Color is the single most common reason a QR code fails to scan. Understanding the rules around contrast, darkness and error correction will save you from printing a code that nobody can read.

In This Guide

The fundamental rule
Contrast ratios
Safe combinations
What to avoid
Logo and color
FAQ

The Fundamental Rule

QR scanners work by detecting the contrast between dark modules (dots) and a light background. The rule is simple: dark modules, light background.

Invert this — light dots on a dark background — and many scanners fail, even when the image looks perfectly clear to a human eye. Phone cameras use software optimised for dark-on-light; reversing the pattern confuses the decoder.

⚠ Never invert a QR code (light dots on dark background). This is the single most common cause of un-scannable QR codes.

Contrast Ratios

The Web Content Accessibility Guidelines (WCAG) define a contrast ratio of 4.5:1 as the minimum for readable text. QR codes benefit from similar thresholds. As a practical guideline:

7:1 or above: Excellent — black on white. Scans reliably from any distance with any scanner.
4.5:1 to 7:1: Good — most branded color combinations fall here. Test before printing.
3:1 to 4.5:1: Risky — will work in ideal conditions but may fail on older phones or in poor light.
Below 3:1: Avoid — unreliable.

FREE QR 360's generator includes a live contrast health indicator that warns you before you download a code with insufficient contrast.

Safe Color Combinations

Dark navy blue dots on white — excellent scan rate, professional look.
Dark forest green on white — reliable and distinctive.
Your brand primary (if dark) on white — works well if the color is darker than medium gray.
Black on light cream or very pale backgrounds — works well; avoid heavily saturated yellows.

What to Avoid

Inverted colors — white/light dots on black/dark background (most scanners fail)
Red dots on green background or vice versa — low luminance contrast, scanner failures common
Yellow dots — yellow has low luminance; scanners struggle regardless of background
Gradients that include a light section — if part of a gradient dot becomes too light, the decoder loses those modules
Low-contrast backgrounds — placing a dark QR on a dark photo or patterned surface

Logos and Color

When adding a logo, use the error correction level M or H. These allow up to 15–30% of the QR pattern to be obscured while remaining readable. The logo replaces some modules, so the error correction recovers the missing data.

Keep the logo under 25% of the QR area. The generator enforces safe sizing automatically.

Can I use a gradient for my QR code?

Gradients are possible but risky. If the gradient transitions from dark to light across the QR modules, the lighter section will fail to scan. If you use a gradient, keep all colors above a 4.5:1 contrast ratio with the background. Always test before printing.

Can I use a colored background instead of white?

Yes — any background color works as long as the contrast ratio with your dot color is sufficient. A very pale blue background with dark navy dots, for example, works reliably.

My branded QR code is failing to scan. What should I check?

First check contrast — the dots must be significantly darker than the background. Second, verify you have not inverted the colors. Third, check that the quiet zone (white margin) is present on all four sides. Finally, test on three different phones.

Try It Now — Free

No account required. Download PNG or SVG instantly.

Create Free QR Code