Wi-Fi QR Code Not Working? 15 Causes and How to Fix Each One
A practical troubleshooting guide for Wi-Fi QR codes that won't scan, scan but won't connect, or connect without internet. Covers wrong passwords, special characters, security types, 2.4 vs 5 GHz, hidden networks, MAC filtering, captive portals and printing problems.
A Wi-Fi QR code should take two seconds: point, tap, connected. When it doesn't work, the cause is almost always one of a short list of problems, and most are quick to fix once you know which one you're dealing with.
The trick is to work out where it fails. Wi-Fi QR codes fail at one of three stages:
- The phone doesn't recognize the code at all. Nothing happens, or it shows plain text.
- The phone recognizes the code but can't join the network. You see "Unable to join," "Incorrect password" or it just spins.
- The phone joins but there's no internet. It's connected, but nothing loads.
Find your stage below and work through the causes in order. They're listed from most to least common.
Stage 1: The Code Won't Scan
1. The code is too small, blurry or damaged
Phone cameras need enough detail to read each square. Codes printed smaller than about 2 cm (under an inch), printed at low resolution, or scuffed, folded or partly covered can fail.
Fix: Reprint at a larger size, around 5 cm (2 inches) or more for table or wall signs, from the original high-resolution file rather than a screenshot. Keep the code flat. Our QR code size guide has sizing rules by distance.
2. Poor contrast or inverted colors
Light codes on dark backgrounds, pastel codes and codes on busy patterned backgrounds confuse many scanners.
Fix: Use a dark code on a white or very light background.
3. No quiet zone
QR codes need a margin of blank space around them, typically equal to about four of the code's small squares. If the code is cropped tight or text runs right up to it, scanners may fail.
Fix: Leave a clear white border on all four sides.
4. Glare
Glossy paper, laminate and picture-frame glass reflect lights, making part of the code unreadable.
Fix: Use matte paper or matte laminate, or anti-glare glass. Ask guests to tilt the phone slightly.
5. The phone's camera doesn't support Wi-Fi codes
iPhones have recognized Wi-Fi QR codes in the Camera app since iOS 11. Most Android phones running Android 10 or later can scan them from the camera or from a scanner icon in Wi-Fi settings, but some manufacturers' camera apps need QR scanning turned on in camera settings. Older phones may only show the raw text.
Fix: On Android, try the QR icon in Wi-Fi settings ("Add network") or Google Lens. On older devices, connect manually using the network name and password printed beside the code. This is why it's always worth printing them in text.
6. The code shows text instead of a "Join network" prompt
If the scanner shows something like WIFI:T:WPA;S:... as plain text, either the scanner app doesn't support Wi-Fi codes or the code is formatted incorrectly, for example with a typo in the WIFI: prefix or the fields.
Fix: Try a phone's built-in camera instead of a third-party app. If that also shows text, regenerate the code with a dedicated Wi-Fi QR code generator rather than a plain-text QR tool.
Stage 2: Scans, But Won't Connect
7. Wrong password or network name
By far the most common cause. Both are case-sensitive, spaces count, and it's easy to confuse similar characters (0 and O, 1 and l, I and l).
Fix: Check the exact network name on a device that's already connected, or in your router's settings. View the saved password on a connected phone: on recent iOS versions, open Settings, then Wi-Fi, tap the info button next to the network and tap the password; on many Android phones, tap the network and choose Share. Then regenerate the code.
8. Special characters weren't escaped
The Wi-Fi QR format uses ;, :, ,, \ and " as structural characters. If your password or network name includes any of these, they must be preceded by a backslash inside the code. Without escaping, the phone reads only part of the password, and the connection fails as "incorrect password." Dedicated Wi-Fi generators handle this automatically; generic text-to-QR tools usually don't.
Fix: Regenerate the code with a Wi-Fi-specific generator, or escape the characters manually (for example pass\;word).
9. Wrong security type
The code tells the phone which security method to use. If it says WEP and your network is WPA2, or says "no password" when there is one, the connection fails.
Fix: For almost all modern networks (WPA2 or WPA3 personal), choose WPA in the generator.
10. WPA3-only network and an older phone
Some newer routers can be set to WPA3-only mode. Older phones and laptops that don't support WPA3 can't join, whether via QR code or manually.
Fix: In the router, switch to WPA2/WPA3 mixed (or "transition") mode, which lets both kinds of devices connect. Use this especially on a guest network.
11. 5 GHz band or channel not supported by the guest's device
If your router broadcasts separate networks for 2.4 GHz and 5 GHz (often with "-5G" in the name), and the code points to the 5 GHz one, some older or budget devices won't see it at all. A few devices also don't support certain 5 GHz channels.
Fix: Make the guest code for the 2.4 GHz network, or enable band steering so one network name covers both bands.
12. Hidden network flag is wrong
If your network is hidden (doesn't broadcast its name) and the code doesn't say so, some phones won't find it. Conversely, marking a visible network as hidden usually doesn't hurt, but it's best to be accurate.
Fix: Regenerate with the "hidden" option set correctly. Better still, if you hide the network for security reasons, know that hiding doesn't add meaningful security; making it visible often improves reliability.
13. MAC filtering or device limits
Some routers allow only listed devices (MAC address filtering) or cap the number of connected devices. Note that modern phones often use a randomized, "private" Wi-Fi address per network, which can defeat MAC allow-lists.
Fix: Disable MAC filtering on the guest network, or raise the device limit. If you must allow-list devices, ask guests to turn off private Wi-Fi address for your network, though for a guest network, filtering is usually more trouble than it's worth.
14. The phone remembers an old password
If a phone previously joined the network with an old password, it may keep trying the saved one.
Fix: On the guest's phone, forget the network (on iPhone, tap the network in Wi-Fi settings and choose Forget This Network; on Android, tap the network and choose Forget), then scan the code again.
Stage 3: Connected, But No Internet
15. Captive portal, router or internet issues
If the phone joins but nothing loads, the QR code did its job; the problem is the network itself. Common reasons:
- A captive portal (a sign-in or terms page) didn't appear. Open a browser and visit any plain website; the portal usually pops up.
- The guest network doesn't have internet access enabled in the router settings.
- The internet connection is down. Check whether other connected devices work.
- DNS or DHCP problems, for example when the router has run out of addresses to hand out. Restarting the router often helps.
- Content filtering or a firewall rule is blocking traffic for guests.
Fix: Test with another device on the same network. If nothing works, restart the router. If only guests are affected, check the guest network's internet access and DHCP settings.
A Quick Diagnostic Routine
When a guest says "the code doesn't work," try this:
- Scan it with your own phone after forgetting the network. Does the "Join" prompt appear?
- If not, the problem is the code or the print (causes 1 to 6).
- If yes, does it connect? If not, check the password, characters, security type and band (causes 7 to 14).
- If it connects but there's no internet, it's the network (cause 15).
- Test with a second phone of a different brand. If one works and the other doesn't, look at device-specific causes: WPA3, 5 GHz, saved passwords.
Preventing Problems Next Time
- Generate codes with a Wi-Fi-specific tool such as QR Helper's Wi-Fi QR code generator, which escapes special characters for you and builds the code in your browser.
- Test with two phones (iPhone and Android) before printing, each having forgotten the network first.
- Print the network name and password beside the code, so anyone can connect manually.
- Use a guest network in WPA2/WPA3 mixed mode on 2.4 GHz or a band-steered name.
- Keep the original file, so you can reprint without quality loss.
- Reprint whenever you change the password. Wi-Fi codes contain the password itself, so old codes stop working as soon as it changes.
For full setup instructions, see how to make a Wi-Fi QR code, and for keeping your network safe while sharing it, read our Wi-Fi QR code security guide. If you're troubleshooting other kinds of QR codes, our general QR code troubleshooting guide covers link and contact codes.
Frequently Asked Questions
Why does my Wi-Fi QR code work on iPhone but not Android (or the reverse)? Usually a device difference: an older Android camera app without Wi-Fi support, a device that doesn't support WPA3 or 5 GHz, or a saved old password on one phone.
My code worked yesterday and doesn't today. Why? Most often the Wi-Fi password was changed, or the router reset to defaults after a firmware update or power issue. Check the router's current settings and regenerate the code if needed.
Can a Wi-Fi QR code connect laptops? Not easily, as most laptops don't have a built-in QR scanning workflow for Wi-Fi. Print the network name and password for laptop users.
Does a Wi-Fi QR code need internet to work? No. The phone reads the settings directly from the code, so it works even when the internet connection is down, although guests won't be able to browse until the connection is restored.