How to Create a WiFi QR Code
Everything that goes into a working scan-to-connect code — the data format, the phone side, the print side — and the mistakes that break it.
A WiFi QR code is a plain text string wrapped in a QR symbol. Scan it with a phone camera and the phone offers to join the network, with no password typing and no “what’s the WiFi password?” conversation. This guide covers the whole chain: what the code contains, how to generate one, how to verify it, and how to print it so it still works at two metres.
What is actually inside a WiFi QR code?
The payload follows a de-facto standard that both iOS and Android understand:
WIFI:T:WPA;S:MyNetwork;P:MyPassword;H:false;;
T— security type:WPA(covers WPA, WPA2 and WPA3 personal in practice),WEP,nopassfor open networks.S— SSID, the network name exactly as broadcast, including capitals and spaces.P— the password, or blank when the network is open.H—trueif the SSID is hidden, otherwisefalse.;— the terminating double semicolon closes the record.
Characters \, ;, ,, : and " must be backslash-escaped inside the fields. If your password contains a semicolon and the code still fails, that is almost always the reason.
Step 1 — Collect the real network name and password
Read the SSID from the phone that is already connected, not from memory: phone keyboards and router admin pages disagree more often than people expect. On iPhone open Settings → Wi-Fi and look at the ticked network. On Android open Settings → Network & internet → Wi-Fi. Case matters: Cafe-Guest and cafe-guest are different networks.
Also confirm the security mode. Home and small-office routers are almost always WPA2 or WPA3 personal, which the WPA value covers. Open guest networks use nopass, and enterprise networks (WPA2-Enterprise / 802.1X) cannot be expressed in this format at all — those need a captive-portal page instead.
Step 2 — Generate the code
Any generator that runs locally in the browser works. The 365Lab WiFi QR studio asks for exactly those four values, then lets you put the code on a designed poster rather than a bare white square:
- Open the studio and type the SSID, the password and the security type.
- Pick a template, then adjust colours, dot style and the wording around the code.
- Keep the quiet zone: at least four modules of empty space around the symbol, and a light background behind dark modules.
- Export PNG at 300 DPI, or PDF if the sign is going straight to a print shop.
The whole job happens in your browser. The password is never submitted to a server, and the poster is rendered on the local canvas.
Step 3 — Test-scan before you print anything
Display the exported file on screen at roughly the size it will be printed, then scan it with a phone that is not currently on that network — a phone already connected may quietly auto-join and hide a broken code.
- iPhone (iOS 11 and later): open the Camera app, frame the code, and wait for the yellow “Join WiFi Network” banner. Tap it, then confirm Join.
- Android 10 and later: the Camera app or Google Lens reads WiFi payloads and offers to connect. Some manufacturer skins only do this through their own scanner.
- Older Android: may need a dedicated QR scanner app, or a generic scanner that hands the payload to the system.
If nothing appears, the payload is malformed, not the phone. Re-check the SSID spelling first, then the security type.
Step 4 — Print at the right size
QR readability is governed by angular size, so the print size has to match the viewing distance. A useful rule of thumb is one to ten: a code 3 cm wide is comfortable from about 30 cm, a 30 cm code from about 3 m.
| Where the sign lives | Printed code size | Paper |
|---|---|---|
| Counter card, handed over at the till | 3–4 cm | A6 or business-card |
| Table tent, café or restaurant | 4–6 cm | 100 × 150 mm |
| Wall sign, lobby or reception | 10–15 cm | A5 or A4 |
| Window sticker read from a few metres | 20–30 cm | A3 or larger |
Print at 100% — never “fit to page”, which silently rescales the code. Use matte or satin stock under glass; glossy laminates can throw a glare that kills scanning in a lit room. Minimum 300 DPI for anything smaller than A4.
If you want a logo in the middle
It works, within limits. Set error correction to Q (25%) or H (30%), keep the logo under roughly a quarter of the code area, and put a white pad behind it so the module grid stays legible. Then test-scan the final export — not the on-screen preview — because the logo is the difference between a code that scans and one that scans on your phone only.
Make a WiFi QR poster in about two minutes
Type the network details, choose a template, export a print-ready PNG or PDF. Free, no sign-up, nothing uploaded.
Open the WiFi QR studioRelated guides
If you want the raw string itself — field order, escaping, and why one semicolon in a password breaks the code — read the WIFI: payload explained.
Common problems, in order of frequency
| Symptom | Most likely cause | Fix |
|---|---|---|
| Camera sees the code, nothing happens | Payload malformed, wrong T value, unescaped character | Regenerate and re-check SSID, password and security type |
| Phone offers to join, then fails | Password typo, or the phone is out of range | Join manually once to confirm the password, then retest |
| Works on one phone, not another | Older Android camera lacks WiFi payload support | Use a system or third-party scanner app on that device |
| Works on screen, fails in print | Code printed too small, low DPI, glare, or “fit to page” scaling | Print at 100% on 300 DPI matte stock, keep the quiet zone |
| Hidden network never connects | H:true missing | Enable the hidden-network option in the generator |
Frequently asked questions
Can an iPhone scan a WiFi QR code?
What size should a printed WiFi QR code be?
Why does my WiFi QR code not connect?
Do I need an app to generate a WiFi QR code?
Templates that fit this setup
Three layouts picked for this scenario — swap the venue name and password, then export.