Quick sanity checklist
- Code at least 3 cm across
- Dark modules on a light background
- White border left intact
- Security type matches the router
- Hidden flag set when the network is hidden
Why Is My WiFi QR Code Not Working?
Pick the problem you are seeing and work down the list. These checks are ordered so the most common causes come first, and every one of them takes seconds.
1. What exactly happens?
The camera does not even recognise the code
- 1Move closer until the code fills about a third of the frame, and hold the phone steady for two seconds.
- 2Check the size: under roughly 2 cm across, many cameras give up. Reprint bigger.
- 3Check the light. A code behind glass or under a spotlight can glare; step to the side.
- 4Make sure the code is dark on light. Light-on-dark codes fail on many phones.
- 5Try Control Centre on iPhone or the WiFi panel scanner on Android, which sometimes succeeds where the camera view does not.
2. The reference behind each fix
Security types, in plain language
WPA/WPA2-Personal is what almost every home and small business router uses, and it is the most compatible choice. WPA2/WPA3 mixed mode keeps modern phones on the newer standard while old devices still connect. WPA3-only is the most secure but the least compatible: an older phone may simply refuse.
Open networks carry no password at all. WEP is ancient and broken: use it only if a router gives you no other option.
Hidden networks
A hidden network does not broadcast its name, so a phone cannot find it by scanning the airwaves. The WiFi QR format handles this with a hidden flag inside the code.
Type the network name and password as usual, then switch on “Hidden WiFi network”. A compatible phone will join even though it cannot see the network in the WiFi list.
Reserved characters and escaping
The WiFi code format separates its fields with semicolons and introduces each field with a colon, so those characters inside a network name or password would break the structure. The same applies to commas, double quotes and backslashes.
The standard solution is escaping: a backslash in front of the character tells a reader that it is part of the value, not the structure. This generator escapes those characters for you, so you only ever type your real password.
Camera compatibility
iPhone cameras have read WiFi codes since iOS 11. Most Android phones manage it from Android 10, through the camera or the WiFi panel. Older devices may need a QR reader app, and some very old phones cannot join from a QR code at all.
The format is a published standard, but no tool can promise that every reader on earth supports every security type. For maximum reach, use WPA/WPA2, a dark code on a light background, and a generous size.
Still stuck?
Regenerate the code from scratch with the security type set to WPA/WPA2-Personal. That combination works on the widest range of phones, and it removes escaping and security-type problems in one go.
Useful pages
Frequently Asked Questions
In order of likelihood: a typo in the network name, the wrong security type, a hidden network without the hidden flag, or a printed code that is too small or too low in contrast. Work through the walkthrough above and you will find it in a couple of minutes.
Use the WiFi QR code tester. Upload a photo of the code and it shows the network name, the security type and whether the hidden flag is set, all decoded on your device.
No. A QR code is just an image and has no expiry. It stops working only when the network name or password changes, or when the ink fades.