WiFi QR Code Not Working? Fix It in Order
There are only three things that break a WiFi QR code: wrong content, a bad print, or a phone that cannot read it. Identify which one first — the fix is usually five minutes.
“It doesn't scan” covers four different failures: the camera never reacts, the phone offers to join and then fails, only some phones work, or it worked on screen but not on paper. Each has its own cause, so the first step is not to rebuild the code but to sort the symptom.
1. Which failure are you looking at?
| Symptom | Where the problem is | Check first |
|---|---|---|
| Camera sees the code, nothing happens | The payload | SSID spelling, security type, escaped characters |
| A join prompt appears, then it fails | Password or signal | Manual join, distance from the access point |
| Works on one phone, not another | The scanning device | Model, OS version, device management policy |
| Fine on screen, dead after printing | The print | Size, DPI, scaling, glare |
| A hidden or enterprise network never connects | Missing parameters | Hidden-network flag, 802.1X |
2. Payload problems — the three usual suspects
SSID mismatch
Case, spaces, accented characters and a stray trailing space all count. Read the name off a phone that is already connected rather than from memory or a router admin page.
Wrong security type
Home routers are almost always WPA/WPA2 personal — use WPA. Marking a password-protected network as nopass tells the phone to join an open network, which then fails; the reverse fails too.
Unescaped characters
A password containing \, ;, ,, : or " needs a backslash escape. The signature of this bug: typing the password manually works, scanning never does.
The fastest diagnosis is to scan the code with a plain QR reader (not the camera) and look at the text. You should see a complete WIFI:T:WPA;S:...;P:...;; — a missing semicolon or backslash is immediately visible.
3. Print problems — scanners cope, phones don't
- Too small. A 3 cm code suits a 30 cm viewing distance; counter-to-eye is usually more. 4–6 cm for table tents, 10–15 cm for walls.
- Too low resolution. Anything smaller than A4 should be exported at 300 DPI.
- Scaled by the printer. “Fit to page” silently shrinks the code — always print at 100%.
- Low contrast. Light-on-dark, mid-tone backgrounds and coloured modules on a tinted card all reduce recognition rates.
- No quiet zone. Four modules of empty space on every side, minimum.
- Glare and wear. Gloss laminate, acrylic and glass frames produce hotspots under downlights; outdoor signs collect dust and stickers.
4. Device differences
- iPhone: the Camera app has understood WiFi codes since iOS 11 — a banner appears at the top of the screen. If nothing happens, check the OS version, then try a scanner app.
- Android 10 and later: the Camera app or Google Lens handles WiFi payloads; some manufacturer skins only support their own scanner.
- Older Android: the camera may treat anything that is not a URL as invalid. A generic scanning app solves it.
- Managed devices: corporate laptops and handheld terminals often have camera scanning disabled, which is why the password also belongs on the sign in text.
5. Network-side reasons
- Hidden SSID: the payload must include
H:true, otherwise the phone never looks for the network. - MAC allow-listing or a device cap: the router drops unknown devices, or the guest pool is full.
- Captive portal: hotels and shopping centres need a web login; the code only gets the phone onto the network.
- 802.1X: the format cannot carry enterprise credentials — link to an onboarding page instead.
- Band and range: 5 GHz drops off quickly; a 2.4 GHz guest SSID is more forgiving at a distance.
6. The order to rebuild in
- Verify the SSID and password from a connected phone, character by character.
- Set the security type — WPA/WPA2 personal for home and small office.
- Check the password for characters that need escaping.
- Regenerate with the quiet zone intact and error correction at M or higher (Q/H with a logo).
- Test with a phone that is not on that network, then print.
- Print at 100% on matte stock, and scan the printed sheet once more before hanging it.
Most of this is fixed by regenerating once
Check the payload, restyle the code, export a 300 DPI print file — all generated locally in your browser.
Open the WiFi QR studioRelated guides
Frequently asked questions
Why won't my WiFi QR code scan?
Why does the code work on one phone but not another?
The phone says the password is wrong after scanning.
Can I use a QR code for enterprise WiFi?
Templates that fit this setup
Three layouts picked for this scenario — swap the venue name and password, then export.