Verify the network values
Copy the SSID exactly, including spaces, punctuation and letter case. Re-enter the password rather than relying on a remembered version, and confirm whether the network uses WPA/WPA2, WEP or no password.
Check hidden and enterprise networks
Mark the hidden-network option only when the router does not broadcast its SSID. The common WiFi QR format is designed for personal networks; enterprise networks that require a username, certificate or organization-specific onboarding may need a dedicated configuration profile.
Test without exposing credentials
Generation happens locally in the browser, but anyone who can scan the printed code can obtain the access details. Place guest-network codes where intended visitors can reach them and replace the code whenever the password changes.
Test with both an iPhone and an Android device when possible because camera behavior and operating-system support can differ.
WiFi QR troubleshooting order
| Check | Expected value | Typical problem |
|---|---|---|
| SSID | Exact spelling, spaces and letter case | Saved network name is outdated |
| Security | Matches WPA/WPA2, WEP or open | Wrong security type selected |
| Hidden network | Enabled only for a non-broadcast SSID | Hidden flag does not match the router |
| Device support | Test on current iPhone and Android | Enterprise onboarding needs another method |
Pre-production checklist
- Match SSID spelling and letter case
- Confirm password and security type
- Set hidden network correctly
- Use a guest network for public display
- Test on more than one phone
Frequently asked questions
Why does my phone read the QR but not connect?
The encoded values probably do not exactly match the router, or the network requires an enterprise login that the basic WiFi QR format does not provide.
Does a WiFi QR code reveal the password?
Yes. The password is encoded in the QR and can be read by a compatible scanner, so treat the printed code like the credential itself.