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;;
FieldMeaningValuesRequired
TSecurity typeWPA / WEP / nopassStrongly recommended
SSSIDAny string, case sensitiveYes
PPasswordAny string; empty for open networksWhen encrypted
HHidden networktrue / falseOptional, 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

CharacterWrite it asIf 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

5. Self-check: decode it and read it

  1. Scan your export with a plain QR reader, not the camera.
  2. Confirm it starts with WIFI: and has all four fields.
  3. Confirm it ends with two semicolons.
  4. Compare the SSID and password character by character, especially spaces and punctuation.
  5. Look for stray leading spaces — S: Cafe makes 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 studio

Related 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?
A plain string of the form WIFI:T:WPA;S:NetworkName;P:Password;H:false;;. Fields are separated by semicolons and the record ends with a double semicolon. iOS and Android both follow this de-facto convention.
Why do semicolons in a password break the code?
A semicolon is the field separator. Left unescaped it truncates the password or shifts the remaining fields. Backslash, comma, colon and double quote need the same escaping treatment.
How do I encode an open network?
Use T:nopass and leave P empty: WIFI:T:nopass;S:Cafe-Guest;;. Marking an open network as WPA makes phones attempt a password join and fail.
Does it support WPA3 or enterprise WiFi?
WPA3 personal is written as WPA and works in practice. Enterprise 802.1X needs credentials and certificates that this format cannot carry — link to an onboarding page instead.

Templates that fit this setup

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