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?

SymptomWhere the problem isCheck first
Camera sees the code, nothing happensThe payloadSSID spelling, security type, escaped characters
A join prompt appears, then it failsPassword or signalManual join, distance from the access point
Works on one phone, not anotherThe scanning deviceModel, OS version, device management policy
Fine on screen, dead after printingThe printSize, DPI, scaling, glare
A hidden or enterprise network never connectsMissing parametersHidden-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

4. Device differences

5. Network-side reasons

6. The order to rebuild in

  1. Verify the SSID and password from a connected phone, character by character.
  2. Set the security type — WPA/WPA2 personal for home and small office.
  3. Check the password for characters that need escaping.
  4. Regenerate with the quiet zone intact and error correction at M or higher (Q/H with a logo).
  5. Test with a phone that is not on that network, then print.
  6. 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 studio

Related guides

Frequently asked questions

Why won't my WiFi QR code scan?
In order of frequency: the SSID or password does not match the router, the security type is wrong, unescaped special characters broke the payload, the code is printed too small or at low resolution, or the sign is reflecting light.
Why does the code work on one phone but not another?
Older Android cameras cannot read WIFI payloads and only understand URLs; some managed corporate devices block camera scanning entirely. Use the system scanner or a third-party scanning app on those devices.
The phone says the password is wrong after scanning.
Join the network manually once to prove the password works. If that succeeds, the payload is dropping or mangling characters — usually an unescaped semicolon, colon or backslash. Regenerate.
Can I use a QR code for enterprise WiFi?
No. The standard WiFi QR format carries only SSID, password and security type, so 802.1X credentials and certificates cannot be expressed. Point the code at an onboarding page instead.

Templates that fit this setup

Three layouts picked for this scenario — swap the venue name and password, then export.