Tools and method hub
No long article here. Two things only: the three working tools in one place, and an index that finds the right page by symptom. In a hurry? Read the fourth row of the table below — most "it will not connect" reports have nothing to do with the code.
1. Three interactive tools
Payload validator
Enter SSID, password and encryption type; get the exact payload string, byte count, real QR version and module count, plus a recommended print size. Best before exporting.
Use it when: a password may be mistyped, or the name contains non-Latin characters
Size calculator
Enter the distance guests view from; get minimum and recommended side length, pixel size at 300 dpi, and the carrier that fits.
Use it when: sizing a table card, stand or wall sticker
Password generator
Pick length and character sets; by default excludes look-alikes such as 0/O and 1/l/I, and shows an entropy estimate. Uses secure randomness locally.
Use it when: creating a guest network or rotating a password
2. The five-step launch routine
- Settle the network. Decide the SSID and whether staff and guest networks are separate. See staff vs guest networks and SSID naming rules.
- Generate a password. Twelve to fourteen characters, excluding look-alikes; never a birthday or a store name in pinyin.
- Verify the payload. Run the SSID and password through the validator and confirm byte count, escaping and the encryption field before designing.
- Fix the size. Take the calculator's recommendation for your real viewing distance, and keep each module at about 1mm or more (see error correction).
- Export and publish. Choose a template in the studio, re-check against the pre-launch checklist, place it in the fixed position, and log the card ID.
3. Find the fix by symptom
| Symptom | Most likely cause | Page to read |
|---|---|---|
| Camera shows no reaction | Too small, inverted, cropped quiet zone, glare | Troubleshooting table |
| iPhone scans, Android does not (or the reverse) | Payload format or camera differences | iPhone vs Android |
| Reports a wrong password | Payload disagrees with the router, or unescaped characters | Payload validator |
| Connected but pages will not load | DHCP, captive portal, DNS, guest SSID blocked from WAN | Connected but no internet |
| Worked before, fails now | Password rotated or router replaced | Old codes after a rotation |
| Only reads up close | Code too small, modules under 1mm | Size calculator |
| Prints grey or blurry at the edges | Material, glare, ink load, low resolution | Print sizes and materials |
| Stopped working after adding a logo | Too much coverage or too little correction | Logos and tolerance |
| Guests keep asking for the password | No written hint on the card | Guest WiFi signage |
| Putting it on a TV, tablet or menu screen | Brightness, contrast, resolution | On-screen display |
4. Common questions about these tools
Do these tools upload my WiFi password to a server?
No. All three run entirely in your browser; the SSID, password and results never leave your device, and they keep working offline.
What is the minimum sequence to produce a WiFi QR code?
Five steps: pick the network, generate a password, verify the payload, choose a size, then export and publish. In a hurry you can skip verification and go straight to the studio.
Nothing scans — which page should I read first?
Start with the scan-failure checklist and rule out size, quiet zone, glare and inverted colours; only then come back and verify the payload with the content validator.
Do these tools need an install or an internet connection?
No install is required and they work in a mobile browser. After the first visit the page is cached, so the calculations still work offline.
Tools done — now make the card
The studio supports custom colours, templates and PNG or PDF export, all computed locally in your browser.
Open the WiFi QR code studioFor scenario-based guides — restaurant table cards, rental welcome sheets, office dual networks, events, chains — start from all guides. To check whether the code itself is the problem, start from the three tools above.