WiFi QR Code Not Working? 9 Fixes That Work

Updated: 2026-11-03 · 6 min read

You scan the WiFi QR code, the phone says "Join network"... and then nothing. Or the camera ignores the code completely. Usually the problem is one of a handful of small, fixable mistakes.

First, know what's inside the code

A WiFi QR code is plain text in this format:

WIFI:T:WPA;S:NetworkName;P:Password;H:false;;

If any part of that text doesn't match your router exactly, the phone either can't read it or can't connect. Many fixes below simply make this line correct. Most QR scanner apps can show you the raw text inside a code, which is the quickest way to check.

Fix 1: Check the network name (SSID) exactly

The SSID is case-sensitive and includes spaces. "Home WiFi" and "home wifi" are different networks. Some routers also have separate names for 2.4 GHz and 5 GHz bands, such as "HomeWiFi" and "HomeWiFi_5G". Make sure the code uses the network you actually want guests on.

Fix 2: Check the password character by character

A single wrong character breaks the connection. Look out for:

• 0 (zero) vs O (letter)
• l (lowercase L) vs I (uppercase i) vs 1
• Extra spaces at the start or end when copy-pasting

If unsure, log into your router app or settings to see the current password, then recreate the code.

Fix 3: Escape special characters

Semicolons, colons, commas, quotes and backslashes have special meanings in the format. Inside the SSID or password, they must be preceded by a backslash. For example, the password cafe;latte must appear as:

P:cafe\;latte;

Good generators do this automatically, but some simple tools don't. If your password contains these characters and the code fails, try another generator or change the password to avoid them.

Fix 4: Use the right security type

• For WPA, WPA2 and most WPA3 home networks, use T:WPA.
• For an open network with no password, use T:nopass and leave the password empty.
• WEP is outdated and insecure; upgrade your router security if it still uses it.

Some generators write T:SAE for WPA3. Many phones don't understand this and silently fail. Switching the code to WPA usually fixes it, because WPA3 routers commonly run in WPA2/WPA3 mixed mode.

Fix 5: Mark hidden networks

If your router doesn't broadcast the network name, the code must include H:true. Without it, the phone looks for a visible network that doesn't appear. Choose the "hidden network" option in your generator.

Fix 6: Help the camera read the code

If the phone doesn't react at all:

• Increase brightness on the screen showing the code.
• Clean the camera lens.
• Hold steady at 15–30 cm, and make sure the whole code, including its white border, is in view.
• Print larger and with strong contrast: black on white works best. Avoid glossy laminates that reflect light.
• Avoid tiny or stylised codes with logos covering too much of the pattern.

Fix 7: Make sure the phone supports WiFi QR codes

• iPhone: the built-in Camera supports WiFi QR codes on iOS 11 and later.
• Android: Android 10+ phones usually scan from the Camera, Google Lens, or the QR icon next to "Add network" in Wi‑Fi settings. Older phones may need a QR scanner app with WiFi support.

If the camera shows the code text but doesn't offer to join, try scanning from the Wi‑Fi settings screen instead.

Fix 8: Check router-side problems

Sometimes the code is fine and the network is the problem:

• MAC address filtering blocks new devices. Add the guest device or disable filtering on the guest network.
• Device limit reached on the router or hotspot.
• Band issues: older devices can't see 5 GHz or 6 GHz networks; offer a 2.4 GHz network.
• Router needs a restart: a quick reboot clears many temporary issues.
• Captive portal networks (hotels, offices) require a login page after joining; a QR code can't bypass this.

Fix 9: Forget old saved networks

If the phone saved the same network earlier with a wrong or old password, it may keep trying the old one. Go to Wi‑Fi settings, tap the network, choose Forget, then scan the code again.

Quick testing checklist

Before printing a code for guests, run through this:

1. Read the raw text with a scanner app and confirm SSID, password and type.
2. Test on one Android phone and one iPhone.
3. Test from a few steps away, as a guest would.
4. Write the network name below the code as a backup.
5. Recreate and reprint the code whenever you change the password.

Creating codes that just work

A dedicated app reduces mistakes. Wifi QR Connect for Android lets you create a WiFi QR code by entering the network name, security type and password, scan WiFi QR codes to connect to compatible networks, and share your hotspot with a QR code. It also shows current WiFi connection information, which helps you confirm the exact network name, and includes a download/upload speed test to check the connection once you're on. History of scanned and created codes stays on your device.

Preventing problems next time

Most QR troubles happen when something changes after the code is made. A few habits avoid them:

• Keep a note of the exact SSID, password and security type you used to create the code.
• Prefer passwords without special characters like ; : , " \ for guest networks, which removes escaping issues entirely.
• Name bands clearly, such as "Home-Guest" for 2.4 GHz, so guests join the right one.
• Re-test after router updates, because firmware updates sometimes change security settings.
• Date your printed codes, so you know which one is current when you change the password.

When the problem is the scanning phone

Sometimes the code is perfect and the issue is the device trying to read it. Before rebuilding your QR code, rule out these phone-side causes:

• WiFi is switched off or airplane mode is on. Some phones read the code but cannot join until WiFi is enabled.
• Too many saved networks or a stale profile. An old saved entry with the same name but a different password can block the new connection; forget it first.
• Restricted work or school profiles. Managed phones may block joining unknown networks entirely.
• Out of range or wrong band. If the phone is far from the router, or the device only supports 2.4 GHz while the network is 5 GHz only, the join will fail even with correct details.
• Camera app limitations. If the built-in camera doesn't offer a "join network" prompt, try a dedicated QR scanner app or the scan option inside WiFi settings.

If one phone fails and another succeeds with the same code, the code is almost certainly fine and the fix lies in that phone's settings.

FAQ

Why does my phone say "Couldn't connect" after scanning a WiFi QR code?

Usually the password or security type in the code doesn't match the router. Check the raw text, fix special characters, and recreate the code.

Why won't my camera detect the WiFi QR code?

Low brightness, glare, a dirty lens, or a code that's too small or heavily styled are the most common reasons. Try better lighting, a larger print, or scanning from Wi‑Fi settings.

Do WiFi QR codes work with WPA3?

Yes on most modern phones when the code uses T:WPA. Codes using T:SAE fail on many devices.

Do WiFi QR codes expire?

No, they don't expire. They stop working only when the network name, password or security type changes.

Can a WiFi QR code connect to a hotel login page network?

It can join the network, but you'll still need to complete any captive-portal login page that the hotel or office uses.