The payload, in full
Every Wi-Fi QR code carries a single string in this shape:
WIFI:T:WPA;S:Guest Network;P:sunflower42;H:false;;
| Field | Meaning | Notes |
|---|---|---|
T | Authentication type | WPA covers WPA/WPA2/WPA3; WEP for legacy; nopass for open |
S | SSID (network name) | Case-sensitive, exactly as broadcast |
P | Password | Omit entirely for open networks |
H | Hidden network | true if the SSID is not broadcast |
Special characters inside a value — backslash, semicolon, comma, colon, double quote — must be escaped with a backslash. That is why a password like a;b"c still works if the encoder handles escaping properly.
What the guest actually sees
iPhone and iPad
Scanning with the built-in Camera app (iOS 11 and later) produces a notification reading "Join 'Network Name'?" with a Join button. One tap connects. No password typing, no Settings app.
Android
Android 10 and later show a Wi-Fi panel with the network pre-selected, and a single tap connects. Earlier versions and some manufacturer skins behave differently: Samsung's camera handles it, but a few OEM scanner apps simply display the raw string. Google Lens is the most reliable fallback.
Desktop
Windows and macOS have no native handler. The string is displayed as text. Do not rely on a Wi-Fi code for laptop users — print the password in readable type as well.
Where to place the code
- Table tents and counter cards. The highest-converting spot in a café or restaurant, because the guest is already seated and looking for it.
- Guest room cards. Bedside table or inside the welcome folder, with the network name printed underneath for anyone who prefers to type.
- Meeting room screens. On the welcome slide for visitors, so nobody stands in the doorway asking for the password.
- Shop windows — carefully. Only if the network reaches outside and the code is large enough to scan through glass. Reflections usually win; a code just inside the door works better.
Sizing for the situation
Wi-Fi payloads are short, so the codes are sparse and scan easily. A 25–30 mm code on a table card is plenty. On a wall sign read from a metre away, go to 60–80 mm.
Matte finish matters more than usual here: these cards sit under downlights, and a glossy laminate will throw a highlight straight across the pattern.
The security conversation
A Wi-Fi QR code is not a secret. Anyone who scans it sees the password, and anyone with a decoder can read it from a photograph — there is no encryption in the format, only encoding.
That is acceptable for a guest network, provided you treat the password as public:
- Use a dedicated guest SSID with client isolation enabled, so guests cannot see each other's devices or reach your internal network.
- Never encode the admin or staff network. Separate VLAN, separate password, no printed code.
- Rotate the password periodically and reprint. Assume it has been photographed.
- Rate-limit guest bandwidth so a leaked password does not become a free ISP for the street.
A static code cannot be revoked. If the password changes, every printed card becomes wrong at once. Either accept the reprint cost, or print a code that points to a page where you publish the current password.
Handling password changes
This is the main operational weakness of a static Wi-Fi code. Three options, in order of practicality:
- Change rarely, reprint in batches. Keep one spare set of table cards and swap them all at once when the password rotates.
- Frame, don't glue. Put the card in a holder so replacing it takes seconds and does not damage the table.
- Encode a redirect. Point the code at
yourdomain.com/wifiand update the password on that page. Note the trade-off: the guest now needs a working connection to load the page, which is exactly what they do not have yet. This only works if the page loads over the venue's open network or mobile data.
Testing checklist
- Scan with an iPhone and an Android phone, from a normal seated position.
- Confirm the network name matches exactly — one trailing space will break it.
- Check that the join prompt appears, not just the raw text.
- Verify the connection actually reaches the internet, not just the router.
- Look at the card under the venue's actual lighting for glare.
Ready to create one? Use the Wi-Fi QR code generator — it escapes special characters and lets you export at print resolution.