The practical answer
First ask whether the camera can decode the code. If it shows a link, investigate the destination. If it shows nothing, check the image, clear border, contrast, size and lighting. Fixing the wrong part wastes time and can lead to unnecessary reprints.
Match the symptom to the next useful check
| What happens | First check | Next action |
|---|---|---|
| The camera shows no result | Focus, glare and the complete border | Try an original download, better light and a plain version without a logo. |
| A URL appears but the page fails | Website availability and internet access | Open the decoded address directly in a browser. |
| The owner can open a file but visitors cannot | File sharing and login requirements | Test the public link while signed out. |
| WiFi details appear but joining fails | Exact SSID, password and security setting | Compare with the router and test from a disconnected device. |
| Screen image scans; physical label does not | Print scaling, surface and image quality | Test a larger, uncompressed proof on the actual material. |
First identify which part failed
If the camera recognises a link but the page does not load, the QR pattern has already worked. Check the address, internet connection, website and sharing permissions. If the camera recognises nothing, work on the image, print size and scanning conditions. These two failures need different fixes.
Try the simplest version
Return to a dark square code on a plain light background with no logo. Keep all of the blank border. Download a fresh SVG or a high-resolution PNG. If the simple version works, add your design changes one at a time and test after each change. This shows which choice caused the problem.
Look for lost space or stretched artwork
Cropping often removes the quiet zone without anyone noticing. Screenshots, document tools and social platforms can also compress an image. Compare the placed artwork with the original download. Make sure the code remains square and the spaces between modules have not blurred or filled in.
Increase the size or reduce the data
A dense contact card or long tracking URL needs more detail than a short link. Make the physical code larger, remove unneeded fields or link to a webpage. Move the camera a little further back if it cannot focus, then bring it closer gradually. Wipe the lens and avoid glare.
Check logos, colours and transparency
A centre logo hides data. High error correction can help, but it does not make any logo or damage pattern safe. Reduce the logo or remove it. A transparent code may look fine in the preview but disappear on dark packaging. Test against the final background, not just the editor.
Check the destination with a fresh device
A cloud document can appear public to its owner while everyone else sees a sign-in screen. Try a private browser window and a second phone. For WiFi, test while disconnected and confirm that the network name and security match the router. For a contact card, inspect the saved fields rather than stopping at the scan prompt.
Keep a tested master
Once the code works, save the final download and print dimensions together. Avoid repeatedly copying screenshots of the code. If a production file is modified, test the modified version again. Our image scanner can help inspect encoded text, but it is not a replacement for a real printed proof.
Example: a working QR with an inaccessible PDF
A venue’s phone recognises the code and opens a cloud-storage page asking for permission. The QR has carried the link correctly. Enlarging the pattern will not remove that access request. The owner needs to adjust the document’s sharing settings or supply a different public destination, then scan again as a guest. If the destination address changes, check whether the printed code is static or managed before deciding on a reprint.
Illustrative example, not a customer case study.
A checklist to use on your next code
- Keep one plain, dark-on-light version as a control sample.
- Change one design choice at a time and record whether it helps.
- Compare at least one other device and a physical print.
- After a successful decode, check the actual destination or saved data.