iPhone vs Android: scanning a WiFi QR code

Same card, same code: the iPhone camera offers to join the network, an Android phone shows a line of WIFI:T:WPA;S:... text, and WeChat does nothing at all. That is not a broken code — it is a difference between scanner apps. Knowing which is which answers most "it won't scan" complaints on the spot.

1. The comparison first

ScannerWhat it does with a WiFi codeJoins automatically
iOS Camera appDetects it and offers "Join network"Yes, once confirmed
iOS Control Centre scannerSame join promptYes
Android system camera (most recent models)Detects it, then a "Connect" tapYes, with one tap
Google Lens / vendor scannerParses the WiFi payload and offers to connectYes
WeChat / messaging appsTreats it as text or a URLNo
Generic QR appsUsually just show the decoded stringNo

The takeaway: joining automatically requires the system camera or a system scanner. So the card should say "scan with your phone camera" next to the code — that one line saves a lot of counter explanations.

2. Five checks on iPhone

  1. Was it the camera? Control Centre's scanner counts too; WeChat, Alipay and in-browser scanners do not.
  2. Is a corner of the code reflecting light? iOS is more sensitive than Android to partial occlusion, especially behind glass or glossy acrylic.
  3. Is there a saved profile with the same SSID? A previously stored network with an old password fails silently. Forget it, then scan again.
  4. Does the network need a captive portal login? Hotels, shopping centres and campuses often do; joining the WiFi is not the same as getting online.
  5. Is Low Power Mode on? On some models it delays the background detection prompt, which looks exactly like "nothing happened".

3. Five checks on Android

  1. Does that scanner understand the WiFi payload? Some vendor cameras and older builds only decode text; you must tap "Connect" on the result.
  2. Can you read the decoded string? If you can see S: (SSID) and P: (password), the code is fine and only the entry point is passive — type it in manually.
  3. Work profile or kids mode. Managed devices may block joining unknown networks, which also looks like nothing happening.
  4. WPA3 versus an older phone. The payload says WPA; if the AP only allows WPA3, older devices may refuse or keep dropping.
  5. Battery saver. Power-saving modes throttle the camera and network scanning, most visibly when scanning from the quick-settings shortcut.

If both phones fail, the problem is the router or the payload. If only one fails, it is that phone. That split tells you whom to fix, and stops you reprinting cards at the counter.

Hidden networks (SSID not broadcast)

A hidden network can still be joined by QR code, but the payload must include the hidden flag (H:true), or the phone assumes the network does not exist. This generator leaves that flag off by default — if your network is hidden, enable the option when generating. Some Android models handle hidden-network codes poorly; those devices need "Add network" by hand.

4. The manual fallback, in words a guest can follow

At the counter, the fastest fix is usually not more code fiddling but one clear sentence:

5. Three things the card itself can pre-empt

What to doWhat it buys you
Print "scan with your camera" and cross out the chat-app iconRemoves the most common misuse outright
Password in small print; SSID written exactly, case and underscoresGives manual entry something to work from
Code edge ≥ 1.2 in (3 cm), quiet zone intact, dark modules on lightRaises recognition on both platforms at once

Unsure about size? Reverse it from scanning distance with the size calculator. Unsure about the payload? The format guide covers every field.

Make one code that both platforms accept

Standard WPA payload, Q-level error correction by default, adjustable quiet zone, 300 dpi PNG / SVG / PDF export.

Open the WiFi QR code studio

Related reading

Frequently asked questions

Why does WeChat not connect the WiFi?
WeChat treats a QR code as text or a link and does not perform the join-network action. To connect automatically you need the system camera on iOS or most Android phones, or the vendor's scanner app. Put "use your camera" on the card.
iPhone shows the join prompt but tapping it does nothing?
Check the password and that the AP is in range, then look for a saved profile with the same SSID — an old profile with a different password fails silently. Forget that network and scan again. Captive portals (hotels, campuses) also need a browser sign-in after joining.
Android only displays the WIFI:T:WPA;... string?
That scanner decodes text but does not act on the WiFi payload. Try the system camera, Google Lens or the vendor scanner, or read the S and P fields from the decoded string and type them in manually.
Can a hidden network be joined by QR code?
Yes, but the payload must carry the hidden flag (H:true), otherwise the phone assumes the network does not exist. Some Android models handle hidden-network codes unreliably, in which case add the network manually.

Templates that fit this setup

Three layouts picked for this scenario — swap the venue name and password, then export.