QR code not scanning? Fix size, contrast and layout

You point your phone at a QR code, but nothing happens. Or the camera recognizes it only when you hold the phone unusually close. Size, contrast, a crowded layout, or a damaged print can all make a code difficult to read.

Try the same information in the QR Code Generator, then scan the result before you print or share it. These checks help you tell whether the problem is the code itself, the printed copy, or the phone's camera.

Test and recreate the QR code

1. Open the QR Code Generator and choose the type that matches your content, such as a link or Wi-Fi network. Enter the same information as in the code that will not scan.
2. Use a dark code on a plain, light background. Avoid a low-contrast color pair, a patterned background, or a design where the background is darker than the code.
3. If the code has a logo over its center, make a version without the logo. Leave an empty margin around the pattern instead of cropping it tightly.
4. Scan the new code on your screen with your phone's camera. Hold the phone steady and move it closer or farther away until the whole code fits in view.
5. If you plan to print it, scan the printed copy too. A code that works on a bright screen may fail on a small, blurry, glossy, or poorly printed version.

Change one thing at a time if you want to find the cause. For example, test a plain version without a logo first, then compare it with a larger print.

What the result means

The new code scans, but the old one does not

The old code is likely too small, crowded, low in contrast, or partly covered. Use the cleaner version and keep its full pattern and surrounding blank margin when you share or print it.

The code scans on screen but not on paper

The printed copy is the likely problem. It may have been shrunk, blurred, cropped, or printed with weak contrast. Check the paper under even light, then print a larger copy from the original image rather than from a screenshot.

The camera shows a link or other preview

The phone has read the QR code. If the link does not open, check that the address is correct and that the phone has an internet connection. That is different from a camera failing to scan the pattern.

No phone can read it

Make a plain, high-contrast version with no logo and a larger print. If that still fails on more than one phone, check that the information was entered correctly and generate the code again.

How to fix a QR code that will not scan

1. Improve the contrast. Use a dark pattern on a light, solid background. Avoid pale code colors, similar foreground and background shades, gradients, and decorative backgrounds. Some phones can read an inverted code, but a dark-on-light design is a more dependable choice.
2. Leave a clear border. QR codes need blank space around the outside so the camera can find the edge of the pattern. A safe baseline is a margin at least four small squares wide on every side. Do not let text, a frame, or the edge of a label touch the code.
3. Remove or reduce the logo. A logo covers part of the information encoded in the pattern. QR codes have built-in error correction, which can help with modest damage, but it cannot guarantee that a large logo will scan. Try the code without a logo first.
4. Make the code larger. If the code is meant to be scanned from farther away, print it larger. A code that holds a lot of information contains more small squares, so it also needs more physical space to remain readable. Test at the size people will actually see.
5. Keep the image sharp. Use the original generated image instead of a screenshot or a copy that has been resized several times. When printing, avoid scaling it down until its edges look soft or uneven.
6. Check the phone and the lighting. Clean the camera lens, hold the phone steady, and avoid glare or deep shadows on the code. Move the phone slowly closer or farther away so the camera can focus.
7. Check the encoded information. If the camera recognizes the code but the result is wrong, recreate it with the correct address, contact details, or Wi-Fi information. For Wi-Fi, verify the network name, password, and security type.

Why layout and content size matter

A QR code stores information as a grid of small squares, often called modules. Longer content usually needs more modules. When the whole pattern is squeezed into the same small space, each square becomes harder for a camera to distinguish, especially on a printed label or from across a room.

The quiet zone is the empty area around the grid. It gives the camera a clean boundary to detect. Cropping this margin, putting a border close to the code, or placing nearby text against it can make scanning unreliable even if the pattern itself is intact.

For color choices, start with a simple dark-on-light pair and test it on the screen and the final print. For more guidance on choosing colors, see how to choose QR code colors that still scan.

Scan the final version from the distance and surface where people will use it before printing or sharing many copies.