Color choices affect whether your QR code scans reliably. This guide explains what works, what to avoid, and how to use brand colors safely.

The one rule that matters

Contrast is everything.

Scanners convert your QR code to grayscale before reading it. They don't see red, blue, or green—only light and dark. Two colors that look different to you might appear identical to a scanner if they have similar brightness.

The difference in brightness between your foreground and background determines whether your code scans.

Contrast ratio basics

Use a contrast checker tool to verify your colors meet the 4.5:1 minimum. Search "contrast ratio checker" online—many free tools are available.

Safe color combinations

Always works

• Black on white
• Dark blue on white
• Dark green on white
• Dark gray on white
• Dark brown on cream

The pattern

Dark foreground + light background = reliable scanning

Your darkest color goes on the QR code modules. Your lightest color goes on the background.

Colors to avoid

Low contrast pairs

These combinations frequently fail:

• Yellow on white
• Light gray on white
• Pastel colors on white
• Light blue on white
• Beige on cream

Red and orange foregrounds

Many scanners use red light for illumination. Red and deep orange QR codes can reflect this light and appear washed out, destroying contrast. Avoid these as foreground colors.

Similar brightness colors

Colors that look different but have similar brightness fail when converted to grayscale:

• Medium green on medium red
• Bright blue on bright orange
• Pastel pink on pastel blue

If you're unsure, convert your design to grayscale. If the QR code blends into the background, it won't scan.

Using brand colors

Step by step

1. Identify your darkest and lightest brand colors
2. Check their contrast ratio (aim for 4.5:1 minimum)
3. Use the darkest color for the QR code, lightest for background
4. If contrast is too low, darken the foreground or lighten the background

When brand colors don't work

If your brand uses light or pastel colors, you have options:

• Use brand colors in the surrounding design, not the QR code itself
• Place the QR code in a branded frame
• Adjust the shade slightly to meet contrast requirements
• Use black for the QR code and brand colors elsewhere

A slightly off-brand QR code that scans is better than an on-brand code that doesn't.

Inverted colors (light on dark)

QR codes with light foreground on dark background can work, but with limitations.

What supports inverted codes

• iPhone camera app
• Android camera app
• Google Lens
• Most modern scanning apps

What may not support them

• Older scanning apps
• Handheld barcode scanners
• Kiosk and point-of-sale scanners
• Event ticket scanners

If you use inverted colors

• Maximize contrast (white on black is safest)
• Test on multiple devices
• Avoid for critical uses like payments or tickets
• Keep the design simple—no logos or complex patterns

Using gradients

FreeQR supports gradients for both foreground and background. Use them carefully.

Gradients that work

• Subtle transitions between two dark colors (navy to dark blue)
• High contrast maintained throughout the entire gradient
• Linear gradients in one direction

Gradients that fail

• Light to dark transitions where part becomes too light
• Rainbow or multi-color gradients
• Radial gradients that create light spots
• Any gradient where the lightest point drops below 4.5:1 contrast

Best practices for gradients

• The lightest part of your gradient must still have 4.5:1 contrast with the background
• Use higher error correction to compensate for any contrast variation
• Test thoroughly before printing

Background considerations

Solid backgrounds

Solid light colors work best. White, cream, light gray, and pale pastels are reliable choices.

Transparent backgrounds

Transparent QR codes only work if you control where they're placed. They fail when placed on dark, patterned, or busy surfaces.

If using transparent backgrounds, ensure the final placement has a light, solid backing.

Patterned backgrounds

Avoid placing QR codes directly on patterns or images. The visual complexity confuses scanners.

If your design requires a patterned background, place the QR code inside a solid-colored box with adequate padding.

Testing your colors

Before printing or publishing:

1. Check contrast ratio with an online tool
2. Convert your design to grayscale—can you still see the code clearly?
3. Scan with your phone's built-in camera
4. Test on both iPhone and Android
5. Try different lighting conditions
6. Print a test copy on your actual materials

Quick reference

Related articles

• How to customize your QR code design
• QR code size guide