WiFi QR Code Not Working? Fixes for iPhone and Android

You scan the WiFi QR code, and… nothing. No connection prompt, an error, or just raw text. Find the heading below that matches what your phone does. Every cause has a fix, and most take under a minute.

Setting up a smart plug, camera or robot vacuum? If the app shows "Invalid QR code! Please wait for WiFi to connect", that is a different problem with its own step by step guide. The fixes below are for joining a network by scanning a WiFi QR code.

1. The camera does not react at all

Native QR scanning needs Android 9+ or iOS 11+. On an iPhone, check that Settings > Camera > Scan QR Codes is switched on, or use the Code Scanner in Control Center. On Android, open your WiFi settings and look for a QR icon next to "Add network": that scanner always works. No camera at all? Screenshot or photograph the code and use our WiFi QR screenshot scanner instead. On a computer, here is how to scan a QR code on a laptop or PC.

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 text decoder to get the network name and password, then connect manually.

3. It scans, then says "Unable to join" or "Couldn't connect"

The code was read, but the phone could not get onto the network. On an iPhone this usually shows as "Unable to join the network". Android may say "Authentication problem", "Check password and try again" or "Couldn't connect". Work down these in order:

• Forget the saved network first. If your phone joined this network before with an older password, it can keep trying the old one. Open WiFi settings, tap the network, choose Forget, then scan again.
• Wrong security type in the code. A code made with WEP selected for a WPA2 network fails silently, and so does a code marked WPA on an open network with no password. 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.
• WPA3-only network, older phone. Some older phones cannot join a network set to WPA3 only. Switch the router to WPA2/WPA3 mixed mode and make the code with WPA selected.
• The router only lets in known devices. With MAC filtering switched on, the password is right but the router still turns new phones away. Add the phone in the router settings, or switch the filter off.

4. It connects, but nothing loads

The phone shows the network as connected, yet pages will not open. Two usual causes:

• A sign-in page sits in front of the WiFi. Hotels, cafes and airports often run an open network with a login page, called a captive portal. The QR code gets you onto the network, but it cannot fill in that page for you. Open your browser, or wait for the sign-in page to pop up, and finish there.
• The router itself is offline. If no other device can get online either, the problem is the internet connection, not the QR code. Restart the router and give it a couple of minutes.

5. Work or school WiFi will not join from a QR code

Networks that ask for a username as well as a password use a system called 802.1X, often labelled WPA2 Enterprise or WPA3 Enterprise. The standard WiFi QR code format has no place for a username, so phones will not join these networks from one, however it is made. Your IT team will have its own setup method, usually a profile or an app.

6. 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.

7. 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.

Still failing? Try a second phone, ideally the other kind. If an iPhone joins and an Android does not, the code is fine and the problem is in that phone's settings.

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.

Do I need an app to scan a WiFi QR code?

Not on most phones. iPhones read them with the Camera app from iOS 11 on, and Android phones from Android 10 on have a scanner in the WiFi settings. Older Android phones need a scanner app.

Why does my phone say connected but nothing loads?

Usually a hotel or cafe sign-in page that the QR code cannot fill in. Open your browser to finish signing in. If other devices are offline too, restart the router.

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. That holds for QR codes generally: static codes never expire, and only codes run through a paid service can be switched off.

Related: all QR code tools

If the message you are getting is "Check connection and try again", the code is probably fine and the problem is the network your phone is on, most often a setup hotspot or a guest WiFi login page.