WiFi QR Code Not Working? 9 Fixes That Actually Work

You scan the WiFi QR code, and… nothing. No connection prompt, an error, or just raw text. Every cause has a fix, and most take under a minute. Work down this list.

1. The camera does not react at all

Native QR scanning needs Android 9+ or iOS 11+. On older phones, or if it is disabled, open your WiFi settings and look for a QR icon next to "Add network" (Android): that scanner always works. No camera at all? Screenshot or photograph the code and use our WiFi QR screenshot scanner instead.

🛠️ Related Tools You Can Try:

2. It scans but shows text instead of connecting

You are seeing the raw contents: WIFI:T:WPA;S:name;P:password;;. Your scanner app does not support the WiFi action. Either use the native camera app instead, or paste that text into our WiFi QR decoder to get the network name and password, then connect manually.

3. Cannot join network after a successful scan

Wrong security type in the code. A code made with WEP selected for a WPA2 network fails silently. Regenerate with the correct type using the WiFi QR generator.
Password changed since the code was printed. The code carries the old password forever. Decode it and compare.
Special characters break the code. Semicolons, colons, or backslashes in the password must be escaped: our format guide explains exactly how.
5 GHz-only network, older phone. The code is fine; the phone cannot see the band. Add a 2.4 GHz SSID.

4. The code itself will not decode

Too small or too far: a printed code needs roughly 1 cm of size per 10 cm of scanning distance.
Low contrast or inverted colors: light-on-dark codes fail on many phones. Regenerate dark-on-light.
Damaged or partly covered: QR codes tolerate about 30% damage, but the three corner squares are sacred: if one is gone, the code is dead.
Glare on laminate: tilt the phone or re-print matte.

5. Still stuck? Decode it manually

Screenshot or photo, then upload to the screenshot scanner and read what is actually inside. Nine times out of ten the broken code contains a typo in the SSID or an old password, and thirty seconds of reading beats an hour of rescanning. If the contents look suspicious rather than broken, a shortened URL where a WiFi string should be, run it through the safe QR scanner before touching it.

Frequently asked questions

Why does the same code work on iPhone but not Android?

Usually hidden-network handling: iOS joins hidden SSIDs from QR more reliably. On Android, add the network manually with the decoded credentials and tick hidden network.

Can a WiFi QR code expire?

The code never expires: but it stops working the moment the network name or password changes, because the old credentials are printed into it permanently.

Diagnose it in two steps
If scanning shows raw text starting WIFI:T:, paste that string into the WiFi QR decoder to see whether the SSID and password actually encoded correctly: a missing trailing ;; or an unescaped character in the password is the usual culprit. Once you know what is wrong, rebuild the code with the WiFi QR generator and test it with the WiFi QR code scanner before reprinting.

Related: all QR code tools