Why Is My QR Code Not Working? How to Fix It

If your QR code is not working, the cause is almost always one of a handful of fixable problems: low contrast between the code and its background, the code printed too small, missing white space around it (the quiet zone), physical damage or distortion, or a broken destination such as a dead URL. Working through these in order will get most codes scanning again.

This guide covers each reason a QR code won’t scan and exactly how to fix it, whether you are designing a code or trying to read one.

1. Low Contrast

QR scanners read codes by detecting the difference between dark and light areas. If the contrast is too low, the scanner cannot tell the modules apart.

Fix it:

• Use a dark code on a light background, ideally black on white.
• Avoid light-colored codes, gradients, or codes printed on a busy photo.
• If you are using brand colors, make sure the dark parts stay genuinely dark. A pale code may look stylish but will not scan.

A common mistake is inverting the colors (light code on dark background). Some scanners handle this, but many do not, so it is safest to keep the code darker than its background.

2. The Code Is Too Small

A QR code needs enough physical size for a camera to resolve its individual squares, especially from a distance.

Fix it:

• For a code scanned from arm’s length, aim for at least 2 x 2 cm (about 0.8 inches).
• For codes on posters or signs scanned from across a room, scale up significantly, often 10 cm or more.
• A simple rule: the scanning distance should be roughly ten times the width of the code.

The more data a code holds, the denser its pattern, which means it needs to be printed even larger to stay readable.

3. Missing Quiet Zone

The quiet zone is the empty margin of clear space around a QR code. Scanners rely on it to find where the code begins and ends. Without it, the code blends into surrounding text or graphics.

Fix it:

• Leave a clear border around the code equal to at least four modules (the small squares) on every side.
• Do not crop tightly or place text and images right up against the edges.
• When laying out a flyer or label, give the code breathing room.

4. Physical Damage or Distortion

QR codes include built-in error correction, so they can survive some damage, but only up to a point.

Fix it:

• Check for scratches, smudges, folds, or print that has worn away.
• Make sure the code is flat. A code on a curved bottle or a wrinkled surface distorts the pattern.
• Reprint badly damaged codes. If more than roughly a third of the code is obscured, even strong error correction cannot recover it.

5. The URL or Destination Is Broken

Sometimes the code scans perfectly, but the destination fails. The scanner is doing its job, the problem is on the other end.

Fix it:

• Confirm the URL is correct and includes https://.
• Open the link in a browser to check the page is still live.
• Watch for typos that were baked into the code when it was created. With a static code, a typo cannot be edited later, you have to generate a new code.

A reliable way to catch this early is to preview the decoded link before relying on the code. QR Toolkit shows you the exact decoded content the moment you scan, so you can confirm a code points where it should before you publish or print it.

6. Scanner or Lighting Problems

Occasionally the code is fine and the issue is the act of scanning itself.

Fix it:

• Clean your camera lens.
• Improve the lighting. Glare and shadows both interfere with scanning.
• Hold the phone steady and parallel to the code, not at a sharp angle.
• Try a dedicated scanner app instead of the camera. If a code is faint or printed on a difficult surface, a purpose-built scanner often reads it when the camera struggles, and it can also scan from a saved photo if needed.

A Quick Troubleshooting Checklist

Run through this list when a code won’t scan:

1. Is there strong contrast (dark on light)?
2. Is it large enough for the scanning distance?
3. Is there clear white space around it?
4. Is the code undamaged and flat?
5. Does the destination URL still work?
6. Is the lighting good and the lens clean?

Nine times out of ten the answer is in there.

Test Before You Trust It

The single best habit is to test every code before it goes live. Scan your own code with at least one other phone, in the conditions where people will actually use it. If you can, save the code and keep a record of it. QR Toolkit keeps a searchable history of the codes you create and scan, so you can quickly re-check or regenerate a code that turns out to have a problem, all decoded on your own device with no ads or tracking.

Frequently Asked Questions

Why does my QR code scan on one phone but not another?

This usually points to a borderline issue like slightly low contrast, a small size, or a tight quiet zone. One camera may cope while another does not. Improving contrast, increasing the size, and adding margin around the code makes it scan reliably on every device.

Can a damaged QR code still be scanned?

Sometimes. QR codes have error correction that can recover the data even if part of the code is missing or smudged, often up to around 30 percent depending on the settings. Beyond that the code becomes unreadable and needs to be reprinted.

My QR code scans but the link is dead. What happened?

The code is fine, but the website it points to has moved or gone offline. Static QR codes cannot be edited after creation, so if the destination changed you will need to generate a fresh code with the correct, working URL.