How to make a Wi-Fi QR code that guests can scan to join
A Wi-Fi QR code holds your network name, security type and password. A phone that scans it offers to join, so nobody has to type a 20-character password off the back of a router.
Processed locally in your browserA Wi-Fi QR code is a QR code that contains your network's name, its security type and its password, written in a standard format that phone cameras recognise. Scanning it offers to join the network, so nobody has to type the password. To make one, choose Wi-Fi in a QR code generator, enter the details exactly as your router has them, and test the code on a phone before you print it.
What is inside a Wi-Fi QR code?
Just a line of text. The format most scanners understand was popularised by the open-source ZXing barcode library, and it looks like this: WIFI:T:WPA;S:Guest Wi-Fi;P:welcome123;;. Each part is a letter, a colon and a value:
| Field | Means | Values |
|---|---|---|
T | Security type | WPA for a password-protected network, WEP for legacy ones, or nopass for an open network |
S | Network name (SSID) | Exactly as the router broadcasts it, including capitals and spaces |
P | Password | Left out for an open network |
H | Hidden network | true if the router doesn't broadcast its name |
Because ;, :, ,, " and \ have a meaning in this format, they must be preceded by a backslash when they appear in a name or password (ZXing wiki, checked 4 November 2026). A network called Cafe;Guest with the password pa:ss1234 is written WIFI:T:WPA;S:Cafe\;Guest;P:pa\:ss1234;;. A good generator does this for you; a hand-made code that skips it is a common reason a code joins the wrong network name or fails outright.
How to make a Wi-Fi QR code
- Find the exact network name and passwordThey are usually on a label on the router, or in its admin page. On many Android phones you can also open Settings › Network & internet › Internet, tap the network you are connected to and tap Share, and the phone shows a ready-made code (Android Help, checked 4 November 2026; some of these steps need Android 12 or later).
- Open the QR Code Generator and choose Wi-FiIn the QR Code Generator, pick Wi-Fi as the content type and type the network name. It is checked as you go: names longer than 32 bytes are rejected, and a name that starts or ends with a space gets a warning, because the code has to match the router character for character.
- Pick the security typeChoose WPA / WPA2 / WPA3 (written into the code as
T:WPA) for almost every home and office router, None for an open network, and WEP only for very old equipment. WPA passwords must be 8 to 63 characters (or a 64-digit hex key), and WEP keys 5 or 13 characters (or 10 or 26 hex digits); anything else is flagged before you download. - Tick Hidden network if it is hiddenIf the router doesn't broadcast its name, the code needs to say so, or phones will look for a network they can't see.
- Download and test itUse SVG or PDF for print, since both stay sharp at any size, or PNG for a screen. Then scan it with two different phones before you print copies.
The code is generated in your browser; the network details are not uploaded to ImageDoctor. After each change the generator also decodes the code again on your device and compares it with what it should contain, which catches a styled design that has broken the symbol.
How do guests scan it?
Most current phones read QR codes from the ordinary camera app. On an iPhone, Apple's instructions are to open Camera in Photo mode, hold the code inside the frame and tap the prompt that appears at the bottom of the screen (Apple Support, checked 4 November 2026). Android phones offer the same through the camera or Google Lens, depending on the maker. The phone then asks whether to join the network.
Laptops usually can't scan a code, so print the network name and password as text next to it. That also helps anyone whose camera won't read the code.
Printing a Wi-Fi sign
For a café table, a holiday let or a meeting room, the QR Poster maker has a Wi-Fi access template that lays out a heading, the network name, the password and the code on one page, ready to print or frame. Two rules from our guide to QR codes that scan matter most here:
- Size it for the distance. A useful rule is about one tenth of the scanning distance: 3 cm wide for a card read at 30 cm, 20 cm wide for a sign read from 2 m away.
- Keep it plain. Dark modules on a light background, with an empty margin around the code. A logo is fine at error correction Q or H, but there is little reason to add one to a Wi-Fi sign.
Is it safe to put a Wi-Fi password in a QR code?
Treat the code exactly like the password written on paper, because that is what it is. The password is stored as plain text: any QR reader app shows it, and anyone who photographs the sign can read it later. Three habits keep that sensible:
- Use a guest network for visitors if your router offers one, so the code never gives access to the computers and devices on your main network.
- Change the password when you need to, then reprint. A Wi-Fi code is static: the old code simply stops working once the password changes, and there is no way to update a printed one.
- Clear the generator's history on a shared computer. ImageDoctor keeps the codes you download or copy in a History list stored only in this browser, so you can reuse them. The Clear button empties it.
Why won't my Wi-Fi QR code connect?
| Symptom | Likely cause | Fix |
|---|---|---|
| Phone says it can't find the network | Name doesn't match exactly, or the network is hidden | Copy the name from the router's settings; tick Hidden network if it is hidden |
| Phone finds it but the password fails | Password changed, or a typo in the code | Check the password on a phone that joins by typing it, then remake the code |
| Older phones refuse to join | The network uses WEP | Switch the router to WPA2 or WPA3; some phones no longer join WEP networks |
| It joins, then a login page appears | The network has a sign-in portal (hotels, some offices) | Expected: the code only gets the phone onto the network |
| Work network asks for a username | WPA2-Enterprise (802.1X) | Not covered by a simple Wi-Fi code; use your organisation's setup instructions |
Common questions
Tools in this article
Keep reading
- QR codes and barcodes that actually scanError correction, quiet zones, logo size, print dimensions and check digits — the practical rules that decide whether a printed code works on the first try.Guides
- Do QR codes expire? Static and dynamic codes explainedA QR code pattern never expires, but the link or service behind it can. How static and dynamic QR codes differ, why codes stop working and how to make one last.