Diagnose a QR scan failure without guessing

Start with the image

On iPhone, open Camera and point it at the entire code, then use the link prompt. On other devices, use the device’s QR scanning feature if available. Keep the square in view, avoid glare, and move the camera gradually until the image comes into focus.

If the picture is on the same phone you are using, try this site’s Upload image option. It processes a selected image in the browser. Camera scanning requires permission and a secure browser context such as HTTPS. A camera-permission failure says nothing about whether the QR image is valid.

Compare the original download with the printed copy

Use the original PNG before testing a screenshot, compressed message attachment, or photo of the print. If the original decodes and the print does not, look at resizing, blur, paper glare, the border, or obstructions in the physical layout.

If neither version decodes, return to a dark pattern on a plain light background and temporarily remove the logo. Change one design choice at a time. Keep an unedited copy so you can tell which change helped.

If you are still in the generator, use Check this QR before exporting. An unreadable result points to the generated image; a mismatch means the decoded value differs from the expected payload. Restore dark-on-light colors and remove logo is available when the design has warnings or the check fails. A passing check can still have color or logo cautions, so review both the result and the warnings.

Read the result before acting

Our scanner displays the decoded value and offers Copy. It offers an Open link action for web URLs; it does not automatically follow the result. A Wi-Fi or contact payload may appear as structured text here even if a phone’s native scanner offers a connection or contact prompt.

Check the host name before opening a link. A familiar brand name elsewhere in the address is not the same as the expected website domain. If a public poster appears to have another QR sticker placed over it, verify the destination with the business using a known contact method.

A repeatable test record

For an important print run, note the file used, the device/browser, whether you scanned a screen or paper, the viewing distance, and the decoded result. Keep image recognition and destination access as separate pass/fail checks. This makes a failure report useful without needing to share a private payload.

Our automated browser checks decode an exported URL PNG and a print-template PNG, and exercise the Check this QR result for readable and unreadable designs. They run in a desktop test browser, so they do not establish compatibility with every phone camera, native contact importer, Wi-Fi implementation, or printer. Test the actual use case before distributing it.