QR code troubleshooting guide
QR Code Not Working? Common Causes and Fixes
Learn why QR codes fail to scan, stop working, open the wrong destination, or become unreadable—and how to fix them.
Create a New QR CodeWhy is my QR code not working?
A QR code may fail because the image is damaged, too small, blurry, low contrast, missing its clear border, or difficult to photograph. It may also scan correctly but lead to a broken, moved, or incorrect destination. Diagnose the image and the destination separately: first confirm that multiple phones can recognize the pattern, then confirm that the decoded URL or data is correct and still available.
- 1 Scan the original digital image. If it works, the print or placement is the problem.
- 2 Try another phone and camera app. If only one device fails, check that device's camera and permissions.
- 3 Open the decoded destination directly. If it fails outside the QR code, repair the page, file, redirect, or network.
QR Code Troubleshooting Checklist
Start with these questions in order. Each answer narrows the problem to recognition, printing, device compatibility, encoded data, or destination availability.
Does the QR code scan at all?
If no phone recognizes it, inspect size, resolution, contrast, quiet zone, damage, glare, and logo coverage. If a scanner shows data, continue with the destination checks.
Does it open the correct page?
Read the decoded URL carefully. A typo, stale campaign link, incorrect redirect, or copied preview URL can send every scan to the wrong place.
Was it printed recently?
Compare the final print with the approved file. Export compression, printer scaling, ink spread, trimming, lamination, or a design edit may have changed the code.
Does it work on another phone?
Test an iPhone and an Android phone when possible. A single-device failure can come from camera focus, an outdated operating system, disabled scanning, or an app-specific limitation.
Is the destination still online?
Paste the exact decoded URL into a browser. Check the web page, PDF, map listing, form, WiFi settings, redirect chain, DNS, SSL certificate, and access permissions.
Is the QR code damaged?
Look for folds, scratches, missing modules, stains, fading, stickers, cropped edges, and blocked corner markers. Reprint when damage prevents consistent recognition.
Why Won't My QR Code Scan?
When a QR code will not scan, the camera cannot reliably distinguish its square modules and positioning markers. The problem is usually visual rather than related to the linked website.
Low contrast
Use a dark code on a light, solid background. Pale foreground colors, dark-on-dark combinations, gradients across the modules, and busy photos reduce the contrast a camera needs to separate the pattern.
Poor lighting or glare
Dim light creates noise and slow focus, while glossy menus, screens, acrylic signs, and metallic packaging can reflect a bright hotspot over the code. Change the angle, add diffuse light, or use a matte finish.
Blurry or distorted printing
Ink bleed, low-quality screenshots, aggressive JPEG compression, stretching, and perspective distortion can merge or reshape modules. Export a sharp PNG at the final size or use SVG/PDF for professional printing.
Physical damage
A QR code has error correction, but it cannot recover unlimited missing information. Damage near the three large finder patterns is especially risky because scanners use those corners to locate and orient the code.
Missing quiet zone
The empty margin around a QR code separates it from nearby text and graphics. Keep a clear border at least four modules wide. Frames, captions, borders, or background patterns must not enter this area.
Low resolution or wrong size
A code that looks acceptable on a design canvas can become unreadable after export or printing. Do not enlarge a tiny raster image. Generate the code at sufficient resolution and test it at its real physical size.
QR Code Scans but Opens the Wrong Page
If the camera recognizes the QR code but the result is wrong, the image is working. The fault is in the encoded value, redirect logic, or destination configuration.
Incorrect destination URL
Decode the QR code and compare every character with the intended URL. Common mistakes include missing path segments, copied staging domains, extra spaces, incomplete tracking parameters, and links copied from an editor preview.
Redirect configuration error
Short links and dynamic QR codes may pass through one or more redirects. Check each redirect hop for loops, outdated rules, country or device targeting, and an incorrect final destination.
Old printed campaign
The QR code may point to a destination that was correct when the material was printed but later changed. Restore the old URL, add a server redirect, or update the destination in the dynamic QR dashboard.
Browser or app handoff
Some links open an installed app while others open a browser. Universal links, deep links, login state, region restrictions, and app versions can produce different results. Always provide a usable web fallback.
QR Code Worked Before but Doesn't Work Now
A previously working QR code usually fails because something changed after publication. Determine whether the code still decodes. If it does, investigate the destination and redirects rather than redesigning the symbol.
Page or file was removed
A deleted landing page, renamed PDF, expired sharing permission, or moved cloud file produces a 404 or access error. Restore the resource at the original address or redirect that address to its replacement.
Domain or website changed
Domain expiration, DNS changes, SSL errors, hosting outages, and site migrations can break a valid encoded URL. Test the destination directly on mobile data and WiFi to separate site failures from local network problems.
URL structure changed
A redesign or content-management migration may change paths. Preserve old URLs with permanent redirects. Printed static codes cannot be edited, so URL continuity is essential.
Managed redirect stopped
A dynamic code depends on its redirect being available. Check whether the campaign is paused, the redirect record was deleted, or the provider is experiencing an outage. Do not assume the QR image itself has changed.
Printed QR Code Not Working
Test the exact production sample, not only the digital proof. Paper, ink, finishing, curvature, viewing distance, and placement can turn a valid file into an unreliable printed QR code.
Printer quality and ink spread
Draft mode, porous paper, worn print heads, and excess ink can blur neighboring modules together. Print at a higher quality, use a suitable substrate, and inspect the smallest squares under good light.
Gloss and reflections
Glossy lamination, glass, polished metal, and backlit displays create reflections that hide part of the pattern. Prefer matte finishes or position the code where typical viewing angles do not reflect direct lights.
Placement and curvature
Avoid folds, seams, corners, bottle shoulders, tight cylinders, and surfaces that move. If packaging curves, increase the code size and keep the complete pattern visible from one camera angle.
Design altered after testing
A designer may crop the margin, recolor the code, place a logo, or resize it after approval. Lock the tested asset and run a final scan check on the actual print-ready PDF and physical proof.
Is the QR Code Too Small?
There is no single minimum size for every situation. Required size depends on scanning distance, code density, print quality, surface, lighting, and camera. About 20 × 20 mm is a practical starting point for simple close-range printed codes, but testing is the deciding factor.
| Format | Practical starting size | Testing advice |
|---|---|---|
| Business card | 20–25 mm | Use a short destination to reduce density. Keep the quiet zone clear and test at arm's length on several phones. |
| Flyer or brochure | 25–30 mm | Place it on a flat area with a clear label. Print a proof at 100% scale rather than judging only on screen. |
| Restaurant menu | 25–35 mm | Account for dim lighting, spills, lamination, and glare. Repeat the code when a large menu is awkward to position. |
| Poster or sign | Based on distance | A useful starting rule is roughly 1 unit of code width per 10 units of scan distance, then validate in the real location. |
| Packaging | 25 mm or larger | Increase size for curved, textured, reflective, or moving surfaces. Keep the code away from folds, seals, and edges. |
Dense QR codes contain smaller modules and need more space. Shorten long URLs or use an appropriate managed redirect, export a vector file, and test from the expected distance before mass printing.
QR Code Color Problems
Scanners work most reliably when the modules are uniformly darker than the background. Branding is possible, but recognition must take priority over decorative color.
Safer design choices
- Black or dark modules on white or a very light solid background.
- Consistent foreground color with strong luminance contrast.
- A complete quiet zone free from text, borders, and images.
- Testing in grayscale and under realistic lighting.
High-risk design choices
- Light modules on a similarly light background.
- Dark code placed directly over a dark photograph.
- Transparent background over changing artwork.
- Patterns, shadows, or gradients that cross finder markers.
Inverted colors
Some scanners handle light modules on a dark background, but support is less consistent. A dark foreground on a light background is safer across older phones, embedded scanners, and varied lighting.
Transparent backgrounds
Transparency can place the code over an unpredictable photo, texture, or product color. Add a solid light background that includes the full quiet zone.
Gradients and multiple colors
A subtle gradient may work when every module remains dark enough, but large brightness changes can erase parts of the pattern. Test the final exported and printed result, not just the editable design.
Screen brightness
A QR code displayed on a phone or kiosk may fail when brightness is low, the screen is cracked, or reflections cover it. Raise brightness, enlarge the code, and remove overlays.
Can a Logo Make a QR Code Unreadable?
Yes. Error correction can tolerate some covered modules, but a logo still removes encoded information. The risk grows with logo size, code density, weak contrast, and poor print quality.
Logo is too large
Keep the center logo modest and test every export. If the code becomes dense, reduce the logo rather than relying on error correction to recover a large missing area.
Finder patterns are blocked
Never cover the three large square markers or their surrounding space. Scanners depend on these patterns to locate, scale, and orient the code.
No separation behind the logo
A detailed logo placed directly on modules can create false shapes. A small solid background patch can improve separation, but the patch also covers data and must remain conservative.
Untested error correction
Higher error correction may improve resilience but creates a denser code. Generate at an adequate size and test the exact logo, colors, destination, and output format.
Dynamic QR Code Problems
A dynamic QR code normally encodes a managed short URL. If it scans but does not reach the destination, inspect the redirect and campaign configuration.
Broken redirect
Open the short URL directly and inspect every redirect hop. Fix loops, invalid targets, malformed tracking parameters, blocked protocols, and server errors.
Disabled campaign or destination
Confirm that the QR campaign is active and the final page, file, form, or listing is publicly available. A working redirect cannot repair a private or deleted destination.
Deleted dynamic record
If the managed redirect record was deleted, recreating a campaign may produce a different short URL and will not repair existing print. Contact the provider before replacing material.
Device or region rule
Conditional redirects can fail for unsupported devices, languages, countries, or app states. Always configure a default destination and test outside your normal account and location.
Static QR Code Problems
A static QR code stores its final data directly in the pattern. That removes redirect dependency, but it also makes an encoded mistake permanent in every downloaded or printed copy.
Wrong data was encoded
Decode the image and compare the exact text, URL, phone number, email, WiFi network name, password, and security type. A visually perfect code cannot correct incorrect source data.
Destination changed
You cannot edit a static code after printing. If you control the encoded web address, redirect that URL at the server. Otherwise, generate a corrected code and replace the material.
Data made the code too dense
Long text and tracking-heavy URLs create more modules. Shorten the payload, remove unnecessary parameters, increase the physical size, and use a high-resolution or vector export.
WiFi details do not match
WiFi codes fail when the network name, capitalization, password, hidden-network setting, or security type is wrong. Test with a device that has never joined the network.
How to Test a QR Code Step by Step
Test recognition, decoded data, destination behavior, and the physical environment separately. A pass on one phone in ideal conditions is not enough for a public campaign.
- 1
Scan the source image
Open the exported PNG, SVG, or PDF at normal size and scan it from another device. If the source fails, regenerate it before investigating print.
- 2
Verify the decoded value
Preview or copy the scan result before opening it. Confirm the full URL, protocol, path, parameters, contact data, or WiFi details.
- 3
Test the destination independently
Paste the decoded URL into a private browser window. Check mobile layout, SSL, login requirements, permissions, redirects, file access, and page speed.
- 4
Test with iPhone Camera
Use the native Camera app in normal lighting. Approach slowly until the banner appears. Also test the Code Scanner control when available.
- 5
Test with Android and Google Lens
Use the native camera on a current Android device, then try Google Lens from the camera, Google app, or image gallery. This catches differences in recognition behavior.
- 6
Test with Samsung Camera
On a Samsung device, confirm that Scan QR codes is enabled in Camera settings. Test both the camera and the quick-panel QR scanner if available.
- 7
Test the physical proof
Scan the actual card, menu, poster, label, or package at its expected distance and angle. Check bright light, dim light, glare, curvature, and normal handling.
- 8
Repeat on different networks
Open the destination on WiFi and mobile data. Network filters, captive portals, regional blocks, DNS, or a local connection can otherwise look like a QR failure.
QR Code Quality Checklist Before Printing
Approve production only after the final asset, final destination, and final physical proof pass these checks.
- ✓ Test the final exported file before placing it in artwork.
- ✓ Verify the exact destination and all redirect hops.
- ✓ Use sufficient size for code density and scan distance.
- ✓ Maintain strong dark-on-light contrast.
- ✓ Leave a clear quiet zone at least four modules wide.
- ✓ Keep logos away from finder patterns and limit coverage.
- ✓ Use SVG or print-ready PDF when the workflow supports it.
- ✓ Do not stretch, skew, crop, or heavily compress the code.
- ✓ Test on iPhone, Android, Google Lens, and Samsung when possible.
- ✓ Test a physical proof under realistic light and viewing angles.
- ✓ Keep the destination public, mobile-friendly, and fast.
- ✓ Assign ownership for monitoring long-running destinations.
Common Real-World QR Code Problems
The fastest fix depends on what the QR code is meant to do. These examples show how to isolate common failures without assuming every problem is caused by the QR image.
Restaurant menu QR code not working
First scan the digital source. Then check glare from lamination, food damage, dim lighting, and whether the menu PDF is public. Reprint with a matte finish and larger code if recognition is inconsistent.
Business card QR code not scanning
Small size, dense contact data, coated stock, and a large center logo are common causes. Simplify the payload, increase the code, preserve its quiet zone, and test the actual card.
PDF QR code opens an error
The code may scan correctly while the file was moved, renamed, deleted, or made private. Restore public access at the same URL or update a managed dynamic destination.
Google Maps QR code is broken
Check whether the link targets the intended place, coordinates, or directions. A changed business listing or copied browser-session URL may produce an unreliable destination.
WiFi QR code will not connect
Confirm the network name, password, capitalization, security protocol, and hidden-network setting. Test with a phone that has forgotten the network so saved credentials do not hide an error.
Event QR code does not load
The registration page may be unpublished, access-restricted, moved, or closed. Check the destination in a private window and provide a fallback contact method on printed material.
Frequently Asked Questions
Why is my QR code not working?
Separate recognition from destination behavior. If no scanner reads the pattern, check size, contrast, resolution, quiet zone, damage, glare, and logos. If it scans, verify the decoded data, redirects, and destination.
Why won't my QR code scan?
The most common reasons are a code that is too small, blurry, low contrast, distorted, reflective, damaged, or surrounded by graphics without a clear quiet zone.
Why did my QR code stop working?
If it worked before, the linked page, file, domain, redirect, permissions, or campaign status probably changed. Decode the code and test its destination directly before replacing the image.
Can a QR code become unreadable?
Yes. Fading, scratches, folds, stains, cropping, ink spread, glare, and heavy logo coverage can remove enough visual information that error correction can no longer recover the data.
Why does my QR code open the wrong page?
The wrong URL may have been encoded, or a short link, server rule, deep link, or dynamic campaign may redirect incorrectly. Inspect the decoded URL and every redirect hop.
How do I test a QR code?
Scan the final digital export, verify the decoded data, open the destination in a private browser, test on iPhone and Android, and scan a physical proof under realistic lighting and distance.
Can a printed QR code stop working?
The print can become unreadable through damage or poor conditions, and its destination can fail or change. The printed pattern does not update itself.
Why doesn't my phone recognize the QR code?
Clean the lens, improve lighting, hold the phone steady, move slightly farther away, enable QR scanning in camera settings, and try Google Lens or another phone.
What size should a QR code be?
About 20 × 20 mm is a practical starting point for simple close-range print, but dense codes, poor surfaces, long distances, and difficult lighting require a larger size. Always test the final format.
Can colors break a QR code?
Yes. Low contrast, inverted colors, transparent backgrounds, and gradients that make modules too light can reduce recognition. Dark modules on a light solid background are safest.
Can a logo make a QR code unreadable?
Yes. An oversized logo can cover too much data, and any logo that blocks the three finder patterns is especially harmful. Keep it modest and test the exact export.
Do QR codes wear out?
A digital QR image does not wear out, but a physical print can fade, scratch, tear, wrinkle, or become covered. The destination behind any QR code can also become unavailable.
Can a website change break a QR code?
Yes. A static code keeps the same URL, so deleting or moving that page can break the result. Preserve old URLs with redirects when changing a website.
How do I fix a damaged QR code?
Use the original source to produce a clean replacement. Digital reconstruction from a badly damaged copy is unreliable, especially when finder patterns or large data areas are missing.
How can I improve QR code scan rates?
Use sufficient size, high resolution, strong contrast, a complete quiet zone, a short clear call to action, accessible placement, a fast mobile destination, and testing across devices.
Why does my QR code work on one phone but not another?
Camera quality, focus distance, operating-system version, enabled settings, scanner software, network state, and deep-link support vary. Improve the code rather than relying on one scanner's tolerance.
Why is my QR code blurry after download?
It may have been exported at a small raster size, compressed, enlarged later, or captured as a screenshot. Download a larger PNG or use SVG/PDF for scalable print.
Why does a QR code fail on a glossy surface?
Reflections can cover the contrast pattern and prevent focus. Change the camera angle, use diffuse light, enlarge the code, or print with a matte finish.
Can I fix a static QR code after printing?
You cannot change data encoded directly in a static pattern. If you control the URL, you may redirect it server-side; otherwise you must replace the printed code.
How do I know whether the QR image or link is broken?
Use a scanner that previews or copies decoded data. If data appears, the image works. Paste that data into the relevant app or browser; a failure there belongs to the destination.
Why does my WiFi QR code scan but not connect?
The encoded network name, password, security type, hidden-network flag, or capitalization may not match the router. Forget the saved network and test again with exact credentials.
Should I regenerate a QR code that is not working?
Regenerate it when the source data is wrong or the image is unreadable. If the code decodes correctly, repair the destination or redirect first so you do not reprint unnecessarily.
Related QR Code Guides
Do QR Codes Expire?
Understand QR code lifetime, service dependency, and expiration-specific failures.
Static vs Dynamic QR Codes
Choose between fixed data and an editable managed redirect before publishing.
Scan QR Codes on iPhone
Test QR codes with iPhone Camera, Code Scanner, and saved images.
Scan QR Codes on Android
Test with Android Camera, Google Lens, Samsung, and other devices.
Google Maps QR Codes
Create and troubleshoot QR codes for places, directions, and map links.
PDF QR Codes
Publish accessible PDF links and avoid file permission errors.
WiFi QR Codes
Encode the correct network, password, and security settings.
Location QR Codes
Share coordinates and location destinations that work across devices.
Google Review QR Codes
Create a direct, testable path to a Google review form.
Need a Reliable QR Code?
Create high-quality QR codes with QR-Build and avoid common scanning problems.
Create QR Code