If a QR code is blurry or will not scan, first distinguish an unreadable image from a link that decodes but fails to open. For image problems, check sharpness, blank margins, contrast, stretching and the conditions where the code will be used. For link problems, inspect the exact encoded destination before changing the artwork.
Does the camera read the code at all?
Point your intended scanner at the final code. If it offers no decoded text or link, investigate the visual code and scanning conditions. If it displays a link but the page fails, investigate that destination. A QR code can be readable while pointing to a typo, expired page or sign-in screen.
Open only destinations you recognize and intend to visit. For your own code, compare the decoded address with the intended address, including any path and required query parameters. Loading a homepage does not prove a campaign or document link is correct.
Match the symptom to a practical check
| Symptom | What to check | Change to evaluate |
|---|---|---|
| Fuzzy or pixelated edges | Original file and size after placement | Regenerate from the source value; use suitable PNG dimensions or SVG where supported |
| Code touches text or a border | Clear margin around all sides | Restore the four-module quiet zone for a standard QR Code |
| Stretched blocks | Whether placement changed width and height independently | Restore the original aspect ratio |
| Readable on screen, unreliable in print | Final printed size, contrast, paper and glare | Test a proof on the intended material and adjust placement or size |
| Very dense pattern | Payload length and code configuration | Use the intended concise URL where possible, or allow more readable space |
| Intermittent scanning | Focus, distance, angle, reflections and lighting | Test under the actual viewing conditions |
| Camera reads a link but it fails to open | Exact payload, redirects and access requirements | Correct the destination or access setup, then regenerate if the encoded value changes |
These are possible causes to inspect, not a guarantee that one symptom identifies a single fault. Compare a clean original with the final placed version to see where reliability changes.
Preserve the quiet zone
DENSO WAVE's code-area guidance specifies a clear margin four modules wide on every side of a standard QR Code. A module is one small square in the pattern. Preserve this space when placing the code beside labels, borders or artwork; a white margin inside the original image can disappear when the image is cropped.
The total printed area includes the symbol and that margin. DENSO WAVE's worked example uses a particular symbol version, module size and printer resolution. It is not a universal minimum print size or camera-distance rule for every phone.
Enjoying this read?
Get weekly insights on video editing, AI workflows, and creator growth straight to your inbox.
Use a clear original rather than enlarging a screenshot
A small screenshot of a QR code may already contain blurred or compressed edges. Enlarging it cannot recover the original module geometry. Generate a fresh code from the intended payload when you can.
PNG stores pixels. Choose dimensions suited to the final placement and inspect the placed result; a fixed pixel count does not guarantee a scan. SVG describes vector shapes and can be useful when the destination tool supports it. It avoids dependence on one source raster size, but later rasterization, cropping or a poor print can still produce an unreadable artifact.
Keep the original aspect ratio and avoid stretching. DENSO WAVE's reading-problem examples explain how processing or resizing can distort modules. Inspect the final exported layout rather than assuming a clean generator preview survives every transformation.
Contrast, density and error correction
Start with dark modules on a plain light background. Check the final material for reflections, patterns or colors that make the code harder to read. A text-accessibility contrast ratio is not a universal QR scanning pass mark.
Longer payloads and the chosen error-correction level can affect the symbol configuration. DENSO WAVE explains the trade-off in its error-correction guidance. Recovery figures concern codewords, not a promise that any similarly sized patch of the visible image can be covered. Increasing error correction does not make arbitrary logos, clipped finder patterns or blurred printing safe.
If you shorten a URL, keep required parameters and use a destination you control or trust. Test its redirects and continued availability. Removing a query string can change the intended page or access behavior even when the remaining address opens.
Create and check a replacement in Cubix
The existing QR Code Generator provides a payload entry, color controls, image size, error correction, a quiet-zone setting and PNG/SVG downloads. Use it to create a replacement, then check the downloaded artifact:
- Enter the exact intended value and compare it with the displayed Encoded value.
- Start with black on white and preserve the standard quiet zone.
- Choose PNG or SVG according to the tool where you will place the image.
- Download the file and decode that file with a suitable decoder. Compare the complete payload with the intended value.
- Place it in the actual design and test that version again. Scaling, export and print are separate stages.
- Scan a print proof or final displayed layout with the intended camera and under expected lighting and distance. Confirm the destination after decoding.
Programmatic decoding can establish what one tested image contains. It cannot establish that a phone camera reads the printed copy. Likewise, a successful screen scan does not prove a business card or poster will work. Record the file, size, device, scanner and conditions of any test you rely on.
Final check before sharing
Check the complete payload, destination access, clear margins and final placement. For print, inspect a real proof before committing to a run. If the code will be used by different devices or in varied conditions, test representative examples and keep the original files for correction. The steps here are troubleshooting instructions, not a claim that a particular printed code has passed those checks.
Don’t miss the next one.
Join our newsletter for exclusive tips, product updates, and the latest from the Cubix team.