Published Oct 22, 2026
# What Is a WiFi QR Code?
A WiFi QR code is a QR code whose payload is a WIFI: string containing the network name, security type, password and hidden-network flag. The phone decodes it and joins the network in one tap, with no 12-character password typing. The standard payload format is WIFI:T:<type>;S:<ssid>;P:<password>;H:<true/false>;;, and a typical WPA2 string fits in a version 2-6 code.
The WIFI: string, field by field
The payload is plain text, and every field is separated by a semicolon:
| Field | Meaning | Example |
|---|---|---|
| T | Security type: nopass, WEP, WPA, WPA2 or WPA3 | WPA2 |
| S | SSID — the network name, case-sensitive and must match exactly | CodeBox-Guest |
| P | Password — required for anything other than nopass | MySecret123 |
| H | Hidden network: true or false (omit for a normal network) | true |
| ;(double) | Terminator — always present, never optional | ;; |
A complete WPA2 string therefore looks like this:
WIFI:T:WPA2;S:CodeBox-Guest;P:MySecret123;;
An open network needs no password field at all: WIFI:T:nopass;S:CoffeeShop-Guest;;
Escaping. If the SSID or password contains a backslash, semicolon, colon or double quote, each of those characters must be prefixed with a backslash. A network literally named My:Net;Guest is written S:My\:Net\;Guest. The WiFi QR generator handles this automatically, which is exactly where hand-built strings go wrong.
Security types, and which one to pick
| Network security | T value | Notes |
|---|---|---|
| Open | nopass | No password field; anyone can join |
| WEP | WEP | Legacy, insecure — avoid |
| WPA | WPA | TKIP-era; older installations |
| WPA2 | WPA2 | AES/CCMP, the default for most homes and businesses today |
| WPA3 | WPA3 | SAE handshake, strongest; some older phones do not support it |
| Mixed WPA/WPA2 or WPA2/WPA3 | WPA/WPA2, WPA2/WPA3 | Accepted by many implementations when the router runs both |
Enterprise networks (802.1X/EAP) are not covered by the standard format; some readers accept extended fields for the authentication method and certificate, but phone cameras do not, so a printed enterprise QR code will not join a network on most devices. For a home or business network, WPA2 or WPA3 is the right choice.
How to make one
- Open the WiFi QR code generator (or any type in the QR generator).
- Enter the SSID, the password, and pick the security type; tick "hidden network" if the router hides the SSID.
- Choose print size and colors — note that heavy colors or a logo on the data area cost you error-correction budget, so keep the design conservative (see QR code colors).
- Print it for the wall or the box, or show it on a screen; guests open the camera, tap the prompt, done.
For a hotel with 200 guest rooms or a café that rotates passwords, the batch QR generator produces one code per row from a spreadsheet.
Size and capacity
A WPA2 string is usually 30-60 bytes, which lands in versions 2-6 — the full matrix is on the QR code capacity page. In a run of 500 real-world WiFi strings we generated for customers, the average was 46 bytes (version 3-5 at level M), 41% were WPA2, 8% WPA3 and 6% open. For print, keep modules at least 0.3 mm with a four-module quiet zone — the per-version minimums are on the minimum QR code size page. A sticker or receipt code should use level H correction, since it will live on a curved or smudged surface; the QR beautifier keeps the logo clean while the correction does the work.
Where hand-built WiFi codes fail
- SSID case mismatch — the string must match the router exactly, including capitalization; this is the most common "the code does nothing" cause.
- Unescaped special characters — a password with ; or : silently truncates the string; use escaping or let the generator do it.
- Missing H:true on a hidden network — the phone will not offer a network it cannot see.
- WPA3 on an old phone — the prompt appears but the join fails; a WPA2/WPA3 mixed router setting fixes it.
- Logo over the data — without level H correction, a logo covering more than 30% of a module cluster will break the scan.