Generators Troubleshooting
QR code won’t scan? Check these things before reprinting
Troubleshoot a QR code that will not scan: quiet zones, contrast, print quality, payload density and destination errors, with a practical test checklist.
A phone that sees nothing and a phone that opens a broken page are reporting different problems. The first suggests trouble recognizing the QR pattern. The second tells you the pattern decoded, but the content or destination needs attention. Start with that distinction before regenerating the image.
1. Restore the clear border around the code
QR symbols need an empty quiet zone around their edges. DENSO WAVE specifies a margin four modules wide on every side, where a module is one small square in the pattern. Cropping the download to the outer black squares, or placing text inside that border, can make recognition harder.
Keep the white border from the generator when placing the artwork in a poster or card. Avoid a textured background immediately beside the pattern, and do not stretch the square into a rectangle.
Sources: DENSO WAVE: QR code area and four-module quiet zone
2. Check contrast, size and the final surface
Start with dark modules on a plain light background. Test without gradients, transparency, decorative overlays or a logo covering the center. A clean download that scans on your screen can still fail after being printed too small, blurred during resizing or placed on a shiny curved surface.
SVG keeps edges sharp when scaled in compatible design software. PNG has a fixed pixel resolution, so use a sufficiently large original rather than enlarging a tiny copy. Neither file format guarantees scanning: the final size, viewing distance and print conditions still matter.
- Print one proof at the intended size, not an enlarged test sheet.
- Scan from the distance a visitor will actually stand.
- Try more than one phone under ordinary lighting.
- Test the final material after lamination or mounting if applicable.
3. Reduce unnecessary content
Longer payloads can require a denser pattern. For a poster linking to a website, a stable concise URL is usually easier to fit than a long address containing unnecessary tracking parameters. Make sure shortening the link does not introduce a redirect service you cannot maintain.
Error correction can recover some damaged data, but it is not permission to erase arbitrary squares. DENSO WAVE describes four correction levels, with a tradeoff between correction capacity and symbol size. ToolBarKit lets you choose a level; test the result rather than assuming the highest option solves every print problem.
4. If it scans, check where it goes
Open the encoded URL directly in a private browser window. Check the address, HTTPS setup and public permissions. A login-only PDF is not a public menu just because a code points to it. For Wi-Fi, confirm the network name, security type and password with the actual network owner.
Scan the downloaded file and the printed proof again after correcting the destination. A successful preview alone does not establish that the exported artwork and public link are ready for use.
Common questions
Should I remove the white border to make the code bigger?
No. Keep the quiet zone and enlarge the entire code, including its border. The clear margin is part of a reliable QR layout.
Is there one safe QR size for every poster?
No universal size covers every payload, scanner and viewing distance. Test the actual printed design under its intended conditions.
Sources and further reading
This guide combines the linked references with examples and the current behavior of ToolBarKit’s tools. Published by the ToolBarKit team; external guidance and tool behavior can change.