WiFi QR Code Format: The WIFI: Payload
The QR symbol is just a container. Everything that decides whether the phone joins the network lives in one line of plain text — and one wrong semicolon is enough to break it.
This payload has no ISO standard number. It is a de-facto convention that Android and iOS converged on, which is why parsers differ in how forgiving they are. When writing one, aim for the strictest interpretation.
1. The structure
WIFI:T:WPA;S:MyNetwork;P:MyPassword;H:false;;
| Field | Meaning | Values | Required |
|---|---|---|---|
T | Security type | WPA / WEP / nopass | Strongly recommended |
S | SSID | Any string, case sensitive | Yes |
P | Password | Any string; empty for open networks | When encrypted |
H | Hidden network | true / false | Optional, defaults to false |
Field order is not strictly significant, though every mainstream generator emits T → S → P → H. The closing double semicolon terminates the record: the first semicolon closes the last field, the second ends the payload. Drop one and some parsers swallow the next token as a new field.
2. Escaping, where most bugs live
| Character | Write it as | If you don't |
|---|---|---|
; | \; | Treated as a separator; password truncated |
, | \, | Some parsers split on it |
: | \: | Can be read as a key/value separator |
" | \" | Closes the string, corrupting the structure |
\ | \\ | Swallows the following character |
Concrete case: a password of Sun;set2026 must be written P:Sun\;set2026. Unescaped, the parser reads the password as Sun and the phone reports a wrong password.
The router admin page shows the password as a human sees it; the QR code carries it as a parser sees it. For any password with punctuation, decode the exported code with a scanning app and read the result.
3. Common variants
Open network
WIFI:T:nopass;S:Cafe-Guest;;
P can be omitted. Marking it WPA with no password makes the phone attempt a password join, which fails.
Hidden network
WIFI:T:WPA;S:Office-Internal;P:pass1234;H:true;;
H:true tells the phone to probe for an SSID that is not broadcast. Android handles this reliably; some iOS versions still depend on the user picking the network manually.
WPA3 personal
Still T:WPA. WPA3 differs in the handshake, not in this four-field vocabulary — personal networks all map to WPA.
Enterprise 802.1X
Not representable. There are no fields for a username, certificate or EAP type, so writing SSID plus password produces a code that cannot connect. Use a custom text/link mode and point at an onboarding or captive-portal page.
4. iOS versus Android
- iOS: the Camera app (iOS 11 and later) shows a Join Network banner. It is strict about missing fields — a payload without
Tis usually ignored entirely. - Android: supported by the Camera app and Google Lens from Android 10; vendor skins vary, and some only support their own scanner.
- Older devices: many cameras treat anything that is not a URL as invalid and need a third-party scanning app.
- Managed devices: corporate policies frequently disable camera scanning, which is why the password should also appear in text on the sign.
5. Self-check: decode it and read it
- Scan your export with a plain QR reader, not the camera.
- Confirm it starts with
WIFI:and has all four fields. - Confirm it ends with two semicolons.
- Compare the SSID and password character by character, especially spaces and punctuation.
- Look for stray leading spaces —
S: Cafemakes the space part of the network name.
Skip the string surgery
The studio handles escaping, the terminator and the hidden-network flag for you, then exports a print-ready poster.
Open the WiFi QR studioRelated guides
A correct payload still has to survive the printer. For size, material and glare, see the printing guide; for the abbreviations themselves, the glossary.
Frequently asked questions
What is the text inside a WiFi QR code?
Why do semicolons in a password break the code?
How do I encode an open network?
Does it support WPA3 or enterprise WiFi?
Templates that fit this setup
Three layouts picked for this scenario — swap the venue name and password, then export.