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;;

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:

  1. Open the studio and type the SSID, the password and the security type.
  2. Pick a template, then adjust colours, dot style and the wording around the code.
  3. Keep the quiet zone: at least four modules of empty space around the symbol, and a light background behind dark modules.
  4. 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.

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 livesPrinted code sizePaper
Counter card, handed over at the till3–4 cmA6 or business-card
Table tent, café or restaurant4–6 cm100 × 150 mm
Wall sign, lobby or reception10–15 cmA5 or A4
Window sticker read from a few metres20–30 cmA3 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 studio

Related 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

SymptomMost likely causeFix
Camera sees the code, nothing happensPayload malformed, wrong T value, unescaped characterRegenerate and re-check SSID, password and security type
Phone offers to join, then failsPassword typo, or the phone is out of rangeJoin manually once to confirm the password, then retest
Works on one phone, not anotherOlder Android camera lacks WiFi payload supportUse a system or third-party scanner app on that device
Works on screen, fails in printCode printed too small, low DPI, glare, or “fit to page” scalingPrint at 100% on 300 DPI matte stock, keep the quiet zone
Hidden network never connectsH:true missingEnable the hidden-network option in the generator

Frequently asked questions

Can an iPhone scan a WiFi QR code?
Yes. Since iOS 11 the built-in Camera app recognises WiFi QR codes: point the camera at the code and a “Join the WiFi network” banner appears; tap it to connect. No third-party app is needed.
What size should a printed WiFi QR code be?
At least 3×3 cm for a code read from about 30 cm away. As a rule of thumb the code should be roughly one tenth of the scanning distance, so a sign read from 3 m needs a code around 30 cm wide.
Why does my WiFi QR code not connect?
Usually a typo in the SSID or password, the wrong security type (home routers normally use WPA/WPA2), or an older Android device whose camera cannot read WiFi payloads. Test with the phone’s own scanner and re-check the network name character by character.
Do I need an app to generate a WiFi QR code?
No. A browser-based generator such as 365Lab’s WiFi QR poster studio builds the code locally, adds a design, and exports PNG or PDF — nothing is uploaded to a server.

Templates that fit this setup

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