Wi-Fi QR Code Not Working? 9 Things to Check

How does a Wi-Fi QR code work?

A Wi-Fi QR code stores structured text describing a network. ZXing documents the common format as fields for security type, network name or SSID, password, and an optional hidden-network flag. A compatible phone reads those fields and offers to join.

The code is not a wireless access point and does not test the router. Correctly decoding stale or incompatible credentials still produces a failed connection. Split the problem into two questions: can the phone read the code, and can the phone join the described network?

1. Is the network name exactly right?

The SSID must match the router's network name exactly, including capitalization, spaces, punctuation, emoji, and other characters.Guest WiFi, GuestWiFi, and guest wifi are different values.

Open Wi-Fi settings on a device already connected to the network and copy the displayed name carefully. Do not use the router brand, your account nickname, or what everyone casually calls the network unless that is the actual SSID.

2. Is the password exact?

Wi-Fi passwords are case-sensitive and may contain spaces or punctuation. One invisible leading space, a curly quote, or a mistaken zero can break the join. Re-enter the password from the router or a device where it is known to work.

The common Wi-Fi payload format requires backslash escaping for special characters such as semicolons, commas, quotes, colons, and the backslash itself. A proper generator handles that encoding. Typing a raw payload by hand is where one escaped BLEEP can become an afternoon.

3. Did you choose the right security type?

The QR security field must match the network. A password-protected WPA or WPA2 network should not be labeled open, and an open network should not include an invented password. Legacy WEP must be identified separately.

JustMakeTheQRCode.com supports WPA/WPA2, legacy WEP, and no-password networks. It does not claim support for enterprise EAP or WPA3-only networks. For broad guest-device compatibility, confirm both the router mode and what your intended phones support.

4. Is the hidden-network setting correct?

Mark the network hidden only if its SSID is actually hidden from normal Wi-Fi lists. ZXing documents an optional H:true field for that case. A mismatch can confuse connection behavior on some devices.

Hiding an SSID is not a strong security control by itself. It simply changes discovery behavior. Use the router's real setting in the code instead of checking the box because “hidden” sounds safer.

5. Did the credentials change after printing?

A static Wi-Fi code always contains the same SSID, password, security type, and hidden flag. If any of those settings change, the old code becomes a beautifully printed set of obsolete instructions.

Generate a new code after a password rotation, router replacement, guest-network rename, or security-mode change. Remove old signs so visitors do not keep scanning the wrong version.

6. Is the network available where you are testing?

The phone must be within range of the exact network, and the router must be accepting connections. Check whether the SSID appears in Wi-Fi settings and whether a known device can join manually using the same credentials.

A successful join without internet access is a different problem. Check the router's upstream connection, captive portal, client limit, access schedule, and guest-network rules.

7. Does the phone support Wi-Fi QR joining?

Device behavior varies by operating system, version, camera app, and manufacturer. ZXing labels the common Wi-Fi format for Android and iOS 11 or later, while current Google Pixel documentation includes QR sharing for saved Wi-Fi networks.

Use the built-in camera or system code scanner first. Update the device if practical. If one phone fails while several others join, the device or its network-security support is the likely variable. Provide the network name and password as a readable fallback when guests must connect reliably.

8. Can the camera read the QR symbol?

If no join prompt appears, treat it as a general scan problem. Give the code better light, fit the whole symbol in frame, clean the camera lens, and try the original digital file. Apple notes that the iPhone Camera and Code Scanner can read QR codes and suggests adding light with the flashlight when needed.

For print, protect the four-module quiet zone, use strong contrast, avoid glare and folds, and increase size when the code is dense. The complete QR scan-failure guide covers the physical checks.

9. Was the Wi-Fi code generated correctly?

Regenerate from a known-good device and compare. Use the exact SSID, password, security mode, and hidden setting. A good generator should escape reserved characters and verify that the QR decodes back to the intended payload.

The free Wi-Fi QR code generator builds the payload and verifies the preview locally in your browser. The SSID, password, and encoded payload are not sent to our server. Still test a real connection before printing or displaying the code.

Use this Wi-Fi QR repair order

1. Join the network manually with the intended credentials.
2. Copy the exact SSID from Wi-Fi settings.
3. Re-enter the exact case-sensitive password.
4. Match WPA/WPA2, WEP, or no-password security.
5. Match the router's hidden-network setting.
6. Generate a fresh code and scan its digital preview.
7. Test with at least two supported phones.
8. Print from the original file with quiet zone intact.
9. Remove every sign containing the stale credentials.

Is it safe to display a Wi-Fi QR code?

Treat the code like the password it contains. Anyone who can scan it can potentially recover or use those credentials. Put visitors on a separate guest network when possible, and display the code only where the intended audience can access it.

Rotate the guest password when access should end, then replace the QR code. Do not put primary-network credentials on a public sign just because the squares look less readable than text.

Frequently asked questions

Why does the Wi-Fi QR code scan but not connect?

The camera read the symbol, but the network rejected or could not use the credentials. Check the exact SSID, password, security type, hidden setting, range, router status, and device compatibility.

Why does an iPhone show no Wi-Fi prompt?

Confirm QR scanning is enabled and use Camera or Code Scanner with the whole symbol visible. Then test another supported phone. A malformed payload or unsupported network security can also prevent a useful prompt.

Can a Wi-Fi QR code work without a password?

Yes. The common format supports nopass for open networks. Select “No password” rather than entering blank WPA credentials. Open networks carry security trade-offs, so use deliberate guest-network controls.

Does changing the Wi-Fi password update the QR code?

No. The old password remains encoded in the static image. Generate, test, print, and distribute a new code after changing any network credential.

Sources

• ZXing, Barcode Contents for Wi-Fi payload fields, security values, and escaping rules.
• Google Pixel Help, Connect to Wi-Fi Networks for current system QR sharing behavior.
• Apple Support, Scan a QR Code With Your iPhone Camera for native scanning and lighting guidance.
• DENSO WAVE, Point for Determining the Code Area for the four-module quiet zone.

Sources checked August 19, 2026.